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Chapter 1 


Introduction 
En ee de 


1.1 Overview 


Welcome to Raima Database Server (RDS) SQL, the extendible, high performance 
client/server SQL Database Management System designed for professional C language 
database application development. 


RDS SQL features include: 
e Conformance to the Microsoft Open Database Connectivity (ODBC) Call-level 
Interface standards 


e Conformance to the 1989 ANSI SQL with integrity enhancement (exceptions noted in 
section 2.3.1) 


e High-speed predefined joins 

e Declarative referential integrity 

e Server-based Extension Modules 

e Server-based, user-defined functions and triggers 

e Stored procedures 

e Database security 

e System catalog 

e High-speed transaction processing with row-level locking 
e Transaction isolation and consistency levels 


This manual contains the complete description of the RDS SQL language that is used to 
store, modify, delete, and retrieve information from an RDS SQL database. A companion 
volume, the Raima Database Server SQL C Programmer's Guide, contains information on 
using RDS SQL from a C application program. 


1.2 Howto Use This Manual 


This manual consists of thirteen chapters and three appendixes. Chapters 1 through 12 
describe the use of RDS SQL through detailed explanations and numerous examples. 
Chapter 13 contains the complete RDS SQL language reference. 
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Chapter 2, "RDS SQL Overview," discusses the RDS SQL system architecture and 
conformance to SQL industry standards, highlights RDS SQL features, and describes 
how to use the interactive RDS SQL utility program. 


Chapter 3, "Relational Database Concepts," defines the basic terms and explains the 
fundamental concepts on which relational databases are based. The example databases 
used in this manual are introduced in this chapter. 


Chapter 4, "Performing Simple Queries," introduces you to the select statement that is 
used to retrieve information from an SQL database. 


Chapter 5, "Computational Queries," shows you how to perform complex queries that 
can do computations on the information in the database. 


Chapter 6, "Nested Queries," explains how to create queries that select information based 
on subqueries. 


Chapter 7, "Entering and Modifying Data," describes how to insert, update, and delete 
database information. Transaction processing and locking are discussed as well as 
importing and exporting data. 

Chapter 8, "Using Views," explains how to create different kinds of views that can be 
used to hide complexity and data. 


Chapter 9, "Database Security," shows how to define data access permissions for each 
RDS SQL user. 


Chapter 10, "Stored Procedures and User-Defined Functions," explains how to create and 
use stored procedures containing precompiled SQL statements. 


Chapter 11, "Database Definition,” describes how RDS SQL databases are defined. 


Chapter 12, "Advanced Topics," addresses such important issues as query optimization, 
multi-user and transaction performance, the SQL system catalog, SQL database 
administration, and low-level RDS database implementation. In addition, it covers 
setting up a user's environment. 


Chapter 13, "Language Reference," contains the complete RDS SQL language in an easy- 
to-use reference format. 


Appendix A, "SDDLP Error Messages," describes each of the errors that can be reported 
by the SQL DDL processor. 


Appendix B, "RDS SQL Status/Error Codes," contains complete descriptions of all of the 
RDS error messages. 


Appendix C, "RDS SQL Syntax Summary," is a summary of the complete RDS SQL 
language. 
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1.3 Notational Conventions 


This section describes how the various symbols and type faces are used in this manual. 
Examples 


Programming examples are boxed and displayed in this typeface (Courier). 


Within the text, example excerpts are in Helvetica, as are any function names or utility 
names (e.g., SQLConnect or ddiproc). 


Syntax Representations 


Syntax statements are in double boxes in the standard typeface. 


Syntax is in the standard typeface. Reserved words are in bold; italics are used for 
variable names; underscores indicate which optional items are selected by default. 


Metasymbols: 
[] Brackets are used to indicate items that are optional. 


| The bar symbol is used to separate alternative selections where only one from 
the list is used at a time. 


Ellipses are used to indicate that the preceding item is to be repeated zero or 
more times. They are also used in programming examples to indicate code 
that has been omitted. 


{} Braces are used to indicate that one and only one of the specified alternatives 
can be chosen. 


In the general text, file names appear in bold italic standard text. Variables or user-defined 
items appear in italics. References to example items and function names appear in 
Helvetica. 
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Chapter 2 


RDS SQL Overview 
a 


2.1 RDS SQL Operation 


The RDS SQL system resides on a Raima Database Server as a tightly integrated layer 
over the RDS runtime system. All of the RDS SQL database operations are implemented 
using the standard RDS low-level function calls. An RDS SQL-specific client library 
containing all of the RDS SQL C application program interface (API) function calls is 
linked with the client application program. These functions interface to RDS through the 
RDS Remote Procedure Call (RPC) subsystem. The RDS SQL system is re-entrant, 
utilizing RDS's multiple thread features. Figure 2-1 shows the system architecture. 


Client Workstation Client Workstation 


Application 


RDS SQL Client Lib. 


Application 


RDS SQL Client Lib. 


Network 


Server Computer 


SQL syscat | 
RDS catalog | 


RPC/Server 


Scheduling 

Lock Mgt. 
RDS Recovery aat 

Cache Mgt, 


Async I/O 


chkpt & log files | 
database files | 


Fig. 2-1. RDS SQL Operational Overview 


At the heart of the RDS SQL system is the system catalog (syscat) containing all of the 
SQL DDL information for each defined database. RDS SQL uses the syscat information 
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to compile and execute each SQL statement. The syscat is created and updated by the 
RDS SQL DDL utility (see Chapter 11, "Database Definition’). 


2.2 RDS SQL Features 


RDS SQL is a full-featured SQL implementation containing a rich set of high performance 
capabilities. Some of the provided features are listed below. 


Ability to open multiple connections to one or more servers. A single client application can 
open several independent, active connections to that same server or any other RDS server 
on the network. 


Incremental database open and close. RDS SQL allows any number of databases to be open 
and active at the same time. 


SQL Data Definition Language. A complete SQL DDL specification that has been prepared 
in a standard text file is processed by a utility that stores the DDL information in the RDS 
SQL system catalog. 


Full automatic referential integrity checking. All of the referential integrity checking 
capabilities defined through the use of the ANSI '89 foreign and primary key declarations 
are available in this release. In addition, RDS SQL DDL includes an additional statement, 
create join, used with foreign and primary key specifications to indicate that direct 
access methods are to be used in maintaining the inter-table relationship. 


Automatic checking of column and table constraints. The ANSI '89 table and column 
constraint features have been fully implemented in RDS SQL. 


Searched and positioned update and delete. Positioned update and delete are used in 
conjunction with the RDS SQL C function interface. Refer to the RDS SQL C 
Programmer's Guide for detailed information. 


Insert statement. The insert values statement is used to insert a single row into a specified 
table. The insert select statement is used to insert one or more rows from one table into 
another. The insert from file statement is used to perform a bulk load from data 


contained in an ASCII text file. 


Expanded data types. RDS SQL allows the definition of date, time, and timestamp data 
types in addition to the standard ANSI SQL data types. 


Null column values. RDS SQL allows columns to have null values. 
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Select statement. The select statement capabilities include all of the ANSI capabilities 
except support for union. Joins, group by, order by, and subquery processing are all 
supported. Moreover, RDS SQL includes a cost-based optimizer that utilizes all indexes 
and RDS's exclusive high-performance predefined joins. 


Scalar functions. A full complement of scalar functions is provided including math, 
string, and date manipulation capabilities. 


View processing. RDS SQL includes create view and drop view statements. Views can be 
used in select, insert, update, and delete statements. Updateable views that have the 
with check option clause will be checked when the view is used in an insert or update 
statement. 


Transactions. RDS SQL provides full transaction processing capabilities including the 
ability to do partial rollbacks. 


Database security. RDS SQL supports the ANSI database security capabilities including 
both grant and revoke. 


Stored procedures. The RDS SQL stored procedures allow SQL statements to be compiled, 
optimized, and stored in the system catalog. 


Extension modules and user-defined functions. RDS SQL provides two important features 
that allow the server capabilities to be extended with application-specific functions. 
Extension modules are C functions that execute on the database server when called bya 
client program. Extension modules can be used to perform a variety of standard 
database operations needed by an application. User-defined functions are similar to 
extension modules in that they, too, are C functions that execute on the RDS server. But, 
instead of being called from the client application, they are called from RDS SQL when 
the functions are used in an expression in an SQL statement. User-defined functions can 
be used to implement triggers. Refer to the RDS SQL C Programmer's Guide for more 
information. 


High Performance Transaction Processing. RDS SQL is built on the RDS database engine, 
which has been designed for high performance transaction-oriented applications. 
Among its state-of-the-art capabilities, the RDS engine optimizes transaction logging and 
recovery and performs asynchronous database I/O, allowing for greater concurrency on 
the server computer. The engine also Piggy-backs output of database pages and 
provides true row-level locking. These provide for efficient use of server memory and a 
large but configurable, efficient database cache. Moreover, four levels of transaction 
isolation are available to RDS SQL users. 
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2.3 SQL Standards 


The need for an industry-wide standard database language has long been recognized. 
There are several loosely related standards for SQL on which the design of RDS SQL has 
been based: 

e 1989 ANSI SQL with Integrity Enhancement 

e SQL Access Group (SAG) and X/Open 

e MS Open Database Connectivity (ODBC) API 

e 1992 ANSI SQL (x3.135-1992, a.k.a. SQL2) 


Each of these standards is described below. 


2.3.1 1989 ANSI SQL with Integrity Enhancement 


As the primary standard on which all others are based, this is the minimally acceptable 
standard to which an SQL implementation should conform. Unfortunately, the 
capabilities that are specified in ANSI SQL do not sufficiently address all of the basic 
requirements of a typical database application. Most notably lacking are date and time 
data types. 


The 1989 ANSI SQL standard specifies two levels of conformance plus an optional 
integrity enhancement. In addition, the standard includes an annex that specifies an 
embedded SQL application program but explicitly states that it is not an integral part of 
the standard. The ANSI specification differentiates Data Definition Language (DDL) 
statements from Data Manipulation Language (DML). Accordingly, conforming 
applications must state which level they conform to for both DDL and DML. They must 
also state whether or not the integrity enhancement feature is implemented. 


This release of RDS SQL provides full SQL (that is, both DDL and DML) level 2 
conformance with the integrity enhancement feature with the following exceptions: 
e The ANSI module language 
e Cursors are based on SAG/MS ODBC (see below), not embedded SQL 
e UNION 
e NUMERIC data type 
e WITH GRANT OPTION 


2.3.2 SQL Access Group 


The SQL Access Group (SAG) is a consortium of vendors and database users whose goal 
is to define a standard database access language that provides for vendor interoperability 
and vendor independence for database applications. SAG works in conjunction with the 
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X/Open effort to provide an internationally accepted standard for open systems. SAG's 
focus has been in the following areas: 


e SQL language definition 

e Embedded SQL 

e Mapping SQL to the Remote Data Access (RDA) transport protocol 
e Defining a C Call-Level Interface (CLI) 


The RDS SQL design is based on the SAG CLI and the SAG language definition. 


2.3.3 Microsoft Open Database Connectivity 


As a leading partner in the SQL Access Group, Microsoft has incorporated the SAG CLI 
into its Windows Open Database Connectivity (ODBC) specification. The goal of ODBC 
is to provide MS-Windows client applications with a true vendor-independent database 
API that will support a wide variety of DBMS server back-ends. With ODBC, a single 
Windows application can simultaneously access multiple database servers from different 
vendors through use of vendor-specific ODBC drivers. 


In addition to the SAG CLI, Microsoft has extended the API with additional functionality 
and, with that, has defined three levels of ODBC compliance, as follows: 


e “Core” level is identical to the SAG CLI. 


e Level 1 functions include all of the core functions, as well as the ability to retrieve 
information, such as table and column definitions that are typically included in a 
system catalog. Level 1 is also able to interrogate the capabilities supported by the 
driver, and to set host DBMS operational parameters such as read repeatability 
and transaction consistency modes. 


e Level 2 supports all level 1 functions, plus scrollable cursors and asynchronous 
processing of client SQL requests. This prevents any Windows application from 
hanging while waiting for the DBMS to complete processing of each request. 

RDS SQL supports all of the core and level 1 and several level 2 functions in its native 
API. Therefore, all of the client platforms supported by RDS SQL conform to this 
important emerging standard. 
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2.3.4 SQL2 


SQL2 is the popular name for what is technically referred to as the 1992 ANSI SQL 
(x3.135-1992) Specification. This is an extensive enhancement of the 1989 ANSI SOL 
standard and is intended to supply many of the features that are needed in most 
database applications and are still missing from current standards. These features 
include: 

e Date, time, and timestamp data types 

e Extensive join processing specifications 

e A standardized system catalog 

e National language support 

e DDL modification support 


The RDS SQL features that have been incorporated from SQL2 are: 


e Limited outer join notation (as specified by ODBC) 
e Date, time, timestamp data types 


2.4 Howto Use the Interactive RDS SQL Utility 


A utility program has been provided that allows a user from a client workstation to 
interactively send RDS SQL statements to the RDS for compilation and execution. This 
utility is designed primarily to aid in the testing of the RDS SQL system. In no way is it 
intended to be used as a substitute for an RDS SQL application program. It is provided 
to help you learn the RDS SQL system. 


RDS SQL statements are submitted one at a time. The program keeps track of the most 
recently entered statements, allowing you to select a previously entered statement, edit it, 
and re-execute it as desired. The program can also process RDS SQL statements stored in 
text files. 


2.4.1 Invoking the RDS SQL Utility 
The RDS SQL utility is called rsq! and is executed as shown below. 


rsql [-e] [-n] [-h num] [-c num] [-s num] [-1 num] [-w num] [startup [arg]...] 


Each of the listed command line arguments is described below. 
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-e This option causes rsql to disable the echo of the commands contained in 
a script file (see .r command, Table 2-2). 


-n This option will cause rsql to suppress the display of its usual copyright 
notice. 
-h num The rsql utility maintains a statement history list containing the num of 


the most recently entered statements. This option sets the size of that 
list. The default is 25. 

-c num This option specifies the maximum number of connections that can be 
opened. The default is 5. 


-s num This option specifies the maximum number of statement handles per 
connection that can be used. The default is 5. 

-lnum This option specifies the number of display lines per output page. The 
default is 25. 

-w num This option specifies the width of the display in columns. The default 
is 80. 


startup[arg]... This is the name of a file containing commands or statements to be 
executed on start-up. An optional argument list can be specified. 
Arguments are positionally referenced within file using a percent sign 
followed by the parameter number beginning at 1 (for example, "%1" 
references the first parameter, "%2" the second, and so on). 


Once you have started rsql, you enter utility commands or RDS SQL statements at the 
prompt ("1 rsql>"). Each statement is terminated by a semi-colon (";") at the end of the 
line. Multi-line statements can be entered simply by pressing <Return> at the end of 
each line. A statement is not considered complete until the program sees a semi-colon at 
the end of a line. An example of a multi-line statement is shown below. 

1 rsql> select sale_name, sum(amount), max(amount), min(amount), avg (amount) 


1+ rsql> from path salesperson to customer to sales_order 
1+ rsgl> group by sale_name; 


2.4.2 RSQL Utility Commands 


The rsq! program has a set of commands to select and edit previously entered RDS SQL 
statements, open and close connections to Raima Database Servers, control use of 
statement handles, read and store statements in text files, and perform some other 
functions as well. Each rsql utility command begins with a special character in the first 
column of the entered statement. A summary of each command is given in the following 
table. 
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Table 2-1. RSQL Utility Command Summary 


Execute the specified operating system command, "oscmd". For 
example, "dir *.tst" would list the files with extension "tst" in the 
current directory. 


Make statement number num the current statement. 


Search down the statement history list to the first statement that 
matches the specified pattern. If no pattern is specified, use the 
last pattern. The pattern is a string containing "%" (match all 
characters) and/or "_" (match a single character). 


Replace the first occurrence (or all occurrences, if "g" is 
specified) of oldtext with newtext in the current statement. 


Perform the specified interface control command. 
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Each utility command begins with the specified special character and is terminated by 
the <Enter> or <Return> key. Only RDS SQL statements are remembered in the 
statement history list. Utility commands are not remembered. 


The current statement is the last statement that was entered, unless you have changed the 
current statement by entering a "-", "+", "#", or "@" command. The "-" or "+" commands 
reposition the current statement relative to the current position either down ("-") or up 
("+") the specified number of statements. The "#" command positions to the specified 
statement number. Specifying a number too low or high positions the current statement 
to the start or end of the list, respectively. 


The "@" command searches down the list for a statement that matches the specified text 
pattern with the wild card characters "%" (match zero or more characters) and "?" (match 
any single character). The search starts from the current statement and proceeds through 
the list until it returns to the current statement. If pattern is omitted, the pattern of the last 
"@" command is used. 


Once you are positioned at the desired statement, you can re-submit it by simply 


nm 


entering ";". 


The current statement can be modified by using the "/" command. The "/" command 
replaces the first occurrence of oldtext with newtext. To replace all occurrences, include a 
"g" (for global change) just after the ending "/". After you enter the text substitution, the 
modified statement is assigned the next statement number, re-displayed, and followed 
by a "+ rsql>" prompt. At this point, you can enter another "/" command to modify the 
statement further, enter ";" to submit the statement, or simply press <Enter> to cancel the 
command. 


The "." character introduces a special interface control command that is used to control 
some aspect of interaction with the RDS SQL server. A summary of these commands 
follows. 
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Table 2-2. Interface Control Command Summary 


Command 


.c [num [srv usr pw]] 


Description 


Switch to server connection number num; if specified, logs in to 
the RDS named server, srv, with user name usr and password 
pw. Connections are numbered between 1 and the limit 
specified by command line option -c (default is 5). The .c 
command by itself displays a list of all connections and the 
names of the servers accessed by them. 


a ————===== 
Disconnect either all connections (.d *) or connection number 


num. 


a — == 
Toggle the statement echo flag. When turned on, each 


f setcursor name 


h [num] 


command or statement processed by an .r command is 
displayed. 


Call SQLGetCursorName to get the system-generated cursor 
name associated with the current statement handle. 


Call SQLSetCursorName to set the cursor name associated with 
the current statement handle to name. 


Switch to statement handle number num. Statement handles are 
numbered between 1 and the limit specified by the command 
line option -h (default is 5 per connection). The -h command by 
itself displays the most recently compiled and executed 
statement for each statement handle in the current connection. 


S ——— === 
When table mode is off, this command fetches the next select 
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statement result row. 


(Continued) 
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(Continued) 


Specify value for 1st parameter marker, 2nd parameter marker, 
and so on. 


Exits program. This closes all statement handles and 
connections, then terminates the program. 


«P par [par]... 


r file [par]... 


Process all of the commands and statements contained in file. 
Both interface utility commands and RDS SQL statements can be 
contained in file, including other .r commands. Any listed 
parameters (par) must be separated by spaces and are passed to 
file. They are positionally referenced within file using a percent 
sign followed by the parameter number beginning at 1 (for 
example, "%1" references the first parameter, "%2" the second, 
and so on). 


Toggle save statement mode. If file is specified, subsequent 
statements are saved (appended) in the named file. If file is not 
specified and save mode is on, save mode will be turned off. 
Otherwise, statements are saved in file rsql.txt. 


Toggle the select statement output display mode between table 
mode and row-at-a-time mode. Row-at-a-time mode is used for 
cursor-based retrieval and positioned updates and deletes. 


Re-execute the compiled statement associated with the current 
statement handle. Calls SQLExecute directly; the statement was 
compiled (through a call to SQLPrepare) when it was first 

submitted. 


Toggle the compile only flag. When turned on, each SQL 
statement is compiled but not executed. 


When table mode is off, this command calls SQLFreeStmt to 
close the active cursor. 
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You can open a connection to any Raima Database Server that is active on the network. 
You can also open multiple connections to the same RDS. Please note that as the rsql 
utility is simply a testing aid, no security precautions have been implemented (for 
example, the password is not blanked out by the program). 


Some of these commands have been implemented specifically to test positioned updates 
and deletes. The following example illustrates how it works. 


1 rsql> .t 
*** table mode is off 

1 rsql> select * from salesperson; 
BNF 
Flores, Bob 
0.135000 
0 
1 
* *NULL* * 


JBW 
Warner, John 


0.115000 

2 

1 

**NULL** 
rsal> .f getcursor 
cursor = SQL CUR 3 1 
regl> «sh 2 
using statement handle 2 of connection 1 
rsql> update salesperson set commission = 0.10 
rsql+ >where current of sql_cur_3_l; 
1 rows affected 
rsql> commit; 


When you are finished, enter the .q command to log out of the connected database 
servers and terminate execution. 
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Chapter 3 
Relational Database Concepts 


3.1 Introduction 


This chapter presents the basic database concepts of relational databases and of SQL. 
Because RDS SQL is based on a relational database language, it is important that you first 
understand relational database concepts. If you are experienced with relational systems, 
you can skip this chapter, although you should at least skim the text to review the 
terminology used in this manual. Terms such as table, column, join, and primary and 
foreign key are defined. Section 3.2 introduces the basic definitions. Section 3.3 explains 
how data relationships are specified in the relational model. Section 3.4 illustrates these 
concepts in a description of the example database used in this manual. 


3.2 Basic Definitions 


Information in a relational database is stored in tables. Each table is composed of columns 
that store a particular type of information and rows that correspond to a particular record 
in the table. A simple but effective analogy can be made with a file cabinet as illustrated 
in Figure 3-1. 


file cabinet = database —P> 


folders = rows 


drawer = table 


Figure 3-1. A File Cabinet Is a Database 


A file cabinet contains drawers. Each drawer contains a set of files organized around a 
common theme. For example, one drawer might contain customer information while 
another drawer might contain vendor information. Each drawer holds individual file 
folders for each customer or vendor, sorted in customer or vendor name order. Each 
customer file contains specific information about the customer. The cabinet corresponds 
to a database, each drawer is like a table, and each folder is like a row in the table. 
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Typically, tables are viewed as shown in Figure 3-2, where the basic components of a 
database table are identified in an example customer table. Each column of the table has 
a name that identifies the kind of information it contains. Each row gives all of the 
information relating to a particular customer. 


column names column 


[company — — [coy _— — | 
A 
Steelers National Bank __| Pittsburgh [PA | 


Figure 3-2. Table Definition 


Suppose that you want to expand this example further and define a simple sales order 
database that, initially, keeps track of salespersons and their customers. Figure 3-3 
shows how this information could be stored in the table. 


[salesperson |commission |company sd city — | 
[McGuire_Sidney| 0.075 | Steelers National Bank | Pittsburgh [PA | 
49ers Venture Group San Francisco 


Figure 3-3. Salesperson Accounts Table 


There are columns for each salesperson's name and commission rate. Each salesperson 
has one or more customer accounts. The customer's company name, city, and state are 
also stored with the data of the salesperson who services that customer's account. Note 
that the salesperson's name and commission are replicated in all of the rows that identify 
the salesperson's customers. Such duplicated data is called redundant data. One of the 
goals in designing a database is to minimize the amount of redundant data that must be 
stored in a database. 


3.3 Relationships and Joins 


To minimize the redundant data in the customer accounts table, we can create two 
separate tables. Information pertaining to each specific salesperson is stored in a 
salesperson table and each customer's information is stored separately in a customer 
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table. When data is divided in this way into multiple tables, the redundant data is 
eliminated. However, the information telling which customers belong to which 
salesperson is also eliminated. To preserve the salesperson /customer relationship, there 
must be some way to relate the two tables to each other. 


The problem is solved by adding another column to both the salesperson and customer 
tables. This new column, sale_id, contains a code that identifies a particular salesperson 
in the salesperson table. In the customer table, the value in the sale_id column of each 
row identifies the particular row in the salesperson table that contains the data for the 
salesperson who services that customer. Figure 3-4 shows the two tables with the 
additional columns. 


Note that there is still redundant data contained in the customer table. However, if the 
sale id code is compact, the amount of redundant data is significantly reduced. This 
process of minimizing redundant data by creating multiple tables is called normalization. 


primary key 


salesperson table 


foreign key Flores, Bob 0.10 
McGuire, Sidney 0.075 


[sale id [company Joy 
Denver 


Figure 3-4. Salesperson and Customer Tables 


Because the sale_id code uniquely identifies a specific salesperson it is called the primary 
key for the salesperson table. The sale_id column in the customer table that associates a 
customer with a salesperson is called a foreign key in the customer table. Each salesperson 
can have many customers but each customer has only one salesperson. This is called a 
one-to-many relationship. When two tables are related one-to-many, the table that 
contains the foreign key is on the many side of the relationship. 


There is an important concept associated with primary and foreign keys called referential 
integrity. Referential integrity means that all of the primary keys associated with all of 
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the foreign keys in the database exist. This means that, for example, all the sale_id 
values in the customer table reference salesperson rows that have a matching sale_id 
value. An important responsibility for a database system is the enforcement of 
referential integrity. 


Tables that are related by their foreign and primary keys can be combined into a single 
virtual table (virtual because the combined table is not stored as an independent entity) 
through an operation called a join. For example, the table in Figure 3-3 could be created 
from the tables in Figure 3-4 with the following SQL query: 


select name, commission, company, city, state 
from salesperson, customer 


where salesperson.sale_id = customer.sale_id; 


The conditional expression that relates the sale_id columns from the two tables is called 
the join predicate. 


The join operation is extremely important in a relational database system. Thus, it is 
imperative that the database management system (DBMS) is able to process joins as 
efficiently as possible. This is typically achieved by indexing all of the primary keys and 
some of the foreign keys as well. An index provides the ability to quickly (usually within 
3 or 4 disk accesses) locate a row in a table based on the primary key value. Some 
database systems support alternative access methods on primary keys that are even 
faster (for example, hashing). In addition to standard indexes, RDS SQL allows primary 
keys to be declared with a special data type called a rowid. A rowid is the row's database 
address which is, as the name suggests, the physical location of the row in the database. 
Thus, a row can be found with a single disk access when located by a rowid primary key. 
Some other database systems refer to database address keys by other terms such as tuple 
id. 

With a foreign and primary key declaration, RDS SQL provides the ability to specify a 
predefined join (through use of the RDS SQL create join statement). Once declared, a 
predefined join will cause RDS SQL to maintain direct relationships between the related 
rows of the foreign and primary keyed tables. This means that when a join is processed, 
each related row can be accessed directly, requiring no more than a single disk access. 
This ability to link the related rows of a join together is exclusively available in RDS SQL 
and is one of the key reasons why faster database applications can be developed with 
RDS SQL. 


It is the function of the database system's query optimizer to determine the fastest way to 
access the results of any join operations that are specified in a query. It does this by 
analyzing all possible accesses based on the indexes and other access mechanisms that 
have been defined. 


What we have been calling a join is technically referred to as either an equi-join or a 
natural join. The table that results from an equi-join contains both columns on which the 
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join is based. For example, the sale_id column would appear twice in Figure 3-4, once 
from the customer table and once from the salesperson table. The table that results from 
a natural join does not contain the redundant column. Thus, Figure 3-4 is the result of a 
natural join between the salesperson and customer tables. 


To get even more technical, suppose that the salesperson table contained rows 
corresponding to newly hired salespersons who do not yet have any customers. An inner 
join results in a virtual table that includes only the salespersons who have at least one 
customer—new hires are excluded. Figure 3-4 would, therefore, correspond to an inner 
natural join of the salesperson and customer tables. An outer join results in a virtual table 
that includes all salespersons and their customers—new hires will appear in the table 
with empty (or null) customer column values as illustrated in Figure 3-5 below. 


salesperson — [commission [company | city state] 
Flores, Bob [0.10 | Seahawks Data Services | Seattle. TWA | 
San Diego 
Blades, Grog J oo] ___—_ T -T 
McGuire, Sidney| 0.075 | Steelers National Bank | Pittsburgh | PA 


[Novice Nate [asp ee 


Figure 3-5. Example Outer Join Result 


(©) 


U 


3.4 Example Database 


The example databases used in the examples in this manual are described in this section. 
Two inter-related databases are used to manage the product inventory and sales 
database for a company that sells computer systems and supplies nationally. The 
inventory database contains product information such as the product codes, descriptions, 
cost and pricing, quantities on hand for each product, and where the product inventories 
are located. The sales database contains information about each salesperson in the 
company, customers, and sales orders. 


The schema diagram for the two databases is shown in Figure 3-6. The arrows represent 
relationships between two tables for which foreign and primary keys have been declared. 
An arrow's source is the table containing the referenced primary key and the arrow's 
destination is the table containing the referencing foreign key. The arrow labels identify 
the foreign key column name (which usually matches the primary key column name). 


The inventory database consists of three tables. The product table contains information 
about each product, including an identification code, description, pricing, and wholesale 
cost. The outlet table identifies all of the company's office and warehouse locations. The 
on_hand table contains the quantity of a specific product (through prod_id) that is 
located at a particular outlet (through loc_id). 
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*invntory” 


salesperson 


sale id 


customer 


note id, note date ord num 


Figure 3-6. Schema for Sales and Inventory Databases 


The sales database is somewhat more complex than the inventory database. The 
salesperson table contains an id code, name, commission rate, assigned sales region, 
office, and a manager id that identifies the corresponding salesperson row of each 
salesperson's manager. The customer table contains the usual data identifying each 
customer. The sale id column is a foreign key of the salesperson that services the 
customer's account. The sales orders made by a customer are identified through the 

cust id foreign key in the sales order table. The sales order table contains the order 
number, date, total amount, and tax for a particular purchase. Associated with each sales 
order are the specific items that the customer purchased. The item table contains product 
and quantity data pertaining to the sales order identified through the ord_num foreign 
key. Notes that can serve as a tickler for the salesperson or that indicate actions to be 
performed for the customer are stored in the note table. Each line of the note text is 
stored as rows of the note_text table. An additional table, called ship_log, contains 
information about sales orders that have been booked but not yet shipped. Rows in this 
table are created by a trigger (see section 10.5, "Triggers"). 
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Chapter 4 
Performing Simple Queries 


4.1 Introduction 


You can retrieve information in an SQL database by submitting queries to RDS. You 
formulate a query by selecting the columns and tables in which you are interested. Not 
surprisingly, the statement that you use to do this is called the select statement. The 
select statement is an extremely powerful command and is the heart of SQL. 


This chapter will introduce you to the basic query capabilities of the select statement, 
including: 

e Opening and closing databases 

e Viewing the contents of a database table 

e Sorting the results of a query 

e Conditionally choosing particular rows of a table 

e Performing queries that join tables together 

e Performing queries across databases 


Subsequent chapters will describe the more sophisticated features of the select statement. 


4.2 Opening and Closing Databases 


Databases are automatically opened by RDS SQL when a reference to any table contained 
in the database is first encountered in the processing of an SQL statement. A database 
can, however, be explicitly opened before you access the information contained in it. 

You can open any database that is contained on the RDS server that you are connected 
to. Of course, you must have the proper permissions to open and access the specified 
database, but that is the subject of a later chapter. The syntax for the open statement is 
given below. 


open dbname [, dbname]... [[as] {share | exclusive}] 


Databases that are automatically opened by RDS SQL are always opened in shared 
mode. You must use the open statement if you want to have exclusive access to the 
database (i.e., no other users will be allowed to access the database while you have the 
database open). You should also use the open statement if there two or more databases 


Performing Simple Queries 4-1 


on the server that have tables declared with the same name. RDS SQL may automatically 
open the wrong database if you do not explicitly open the correct one first. 


For now, let's just assume you are only interested in sales and inventory and that you 
have the necessary access rights. 


The open (use) statement is used to open one or more databases as shown in the 
following examples. 


open sales; 
open sales, invntory exclusive; 


use sales; 
use invntory; 


You can say use or open. Both mean the same thing. Databases can be specified in any 
order and opened at any time. 


The databases remain open until the session ends or you close them using the close 
statement. 


close invntory; 
close invntory, sales; 


All opened databases are automatically closed when the session ends. 


4.3 Basic Queries 


You can enter the following statement to see all of the data in the salesperson table. 


The "*" will choose all of the columns that are declared in the salesperson table. The 
results of this query are shown below. 


SALE_NAME DOB COMMISSION REGION OFFICE bs 
BNF Flores, Bob 1943-07-17 0.100 0 SEA * *NULL** 


GAP Porter, Greg 1949-03-03 0.080 dL SEA * *NULL* * 
BPS Stouffer, Bill 1952-11-21 0.080 2 SEA * *NULL* * 
CMB Blades, Chris 1958-09-08 0.080 3 SEA **NULL** 
SWR Robinson, Stephanie 1968-10-11 0.075 0 BNF 
BCK Kennedy, Bob 1956-10-29 0.070 0 
ERW Wyman, Eliska 1959-05-18 0.070 1 
SKM McGuire, Sidney 1947-12-02 0.075 1 
WAT Jones, Walter 1960-06-15 0.070 2 
WWW Warren, Wayne 1953-04-29 0.075 2 
GSN Nash, Gail 1954-10-20 0.070 3 
Williams, Steve 1944-08-30 0.075 3 
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Each salesperson has a unique id code (the primary key). The mgr_id column is null for 
the regional managers. The salespersons who work for each regional manager have their 
manager's Sale_id code in the mgr_id column (a foreign key). Our fictitious computer 
supply company has four sales regions. Region 0 is west, region 1 is east, region 2 is 
central, and region 3 is south. The company headquarters is located in Seattle with sales 
offices located in Los Angeles (LAX), Denver (DEN), New York City (NYC), Washington 
D.C. (WDC), Chicago (CHI), Minneapolis (MIN), Dallas (DAL), and Atlanta (ATL). The 
office out of which each salesperson works is shown in the table. Also shown is each 
salesperson's birthdate and commission rate. 


If there are only certain columns that you are interested in seeing, you can specify only 
those columns in the select as shown below. 


select sale_name, commission from salesperson; 


SALE_NAME COMMISSION 
Flores, Bob 0.100 
Porter, Greg 
Stouffer, Bill 
Blades, Chris 
Robinson, Stephanie 
Kennedy, Bob 

Wyman, Eliska 
McGuire, Sidney 
Jones, Walter 
Warren, Wayne 

Nash, Gail 
Williams, 


00000000000 


Steve 


You can select any of the columns from the specified table in any order. 


select mgr id, dob, 
select commission, 


sale name from salesperson; 
sale id, office, sale name, 


region from salesperson; 


The output table produced from the selected columns is called a projection in relational 
database parlance. 
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4.4 Sorting Queries 


You can choose to sort the output table of a select using the order by clause. For 
example, the following statement sorts the salesperson table in alphabetical sale_name 
order. 


Select * from salesperson order by sale_name; 


SALE_ID SALE_NAME DOB COMMISSION REGION OFFICE MGR_ID 


CMB Blades, Chris 1958-09-08 0.080 3 SEA **NULL** 

BNF Flores, Bob 1943-07-17 0.100 0 SEA * *NULL** 
WAJ Jones, Walter 1960-06-15 0.070 2 CHI BPS 
BCK Kennedy, Bob 1956-10-29 0.070 0 DEN BNF 
SKM McGuire, Sidney 1947-12-02 0.075 aL WDC GAP 
GSN Nash, Gail 1954-10-20 0.070 3 DAL CMB 

GAP Porter, Greg 1949-03-03 0.080 1 SEA **NULL** 
SWR Robinson, Stephanie 1968-10-11 0.075 0 LAX BNF 

BPS Stouffer, Bill 1952-11-21 0.080 2 SEA **NULL** 
WWW Warren, Wayne 1953-04-29 0.075 2 MIN BPS 
Williams, Steve 1944-08-30 0.075 3 ATL CMB 
man, Eliska 1959-05-18 0.070 1 GAP 


Columns listed in the order by clause can be specified by name or by number. The first 
column in the select list is 1, the second column is 2, and so on. The following lists the 
salesperson names and birthdates in birthdate order. 


select sale name, dob from salesperson order by 2; 


SALE NAME DOB 
Flores, Bob 1943-07-17 
Williams, Steve 1944-08-30 
McGuire, Sidney 1947-12-02 
Porter, Greg 1949-03-03 
Stouffer, Bill 1952-11-21 
Warren, Wayne 1953-04-29 
Nash, Gai 1954-10-20 
Kennedy, Bob 1956-10-29 
Blades, Chris 1958-09-08 
Wyman, Eliska 1959-05-18 
Jones, Walter 1960-06-15 
Robinson, Stephanie 1968-10-11 


You can also sort on more than one column as well as being able to specify whether each 
column is in ascending (the default) or descending order, as in the next example. 
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select commission, 


sale_name from salesperson order by 1 desc, 


COMMISSION SALE_NAME 
0.100 Flores, Bob 
0.080 Blades, Chris 
0.080 Porter, Greg 
0.080 Stouffer, Bill 
0.075 McGuire, Sidney 
0.075 Robinson, Stephanie 
0.075 Warren, Wayne 
0.075 Williams, Steve 
0.070 Jones, Walter 
0.070 Kennedy, Bob 
0.070 Nash, Gail 
0.070 Wyman, Eliska 


Column 1 is the primary sort column. The values in column 2 that have identical column 
1 values are sorted within that group. 


4.5 Conditional Row Selection 


The previous examples selected all of the rows in the salesperson table. However, you 
often want to select data that meets a specific set of selection criteria. You can use the 
where clause of the select statement to specify which particular rows to select. 


For example, the following query will select only those customers who have a sale_id 
equal to "SKM" (that is, the customer accounts that are serviced by Sidney McGuire). 


select sale_id, cust_id, company, city, state from customer 
where sale id = "SKM"; 


CUST ID COMPANY CITY STATE 
SKM PHI Eagles Electronics Corp. Philadelphia PA 
SKM PIT Steelers National Bank Pittsburgh PA 
SKM WAS Redskins Outdoor Supply Co. Arlington VA 


The where clause contains a conditional expression consisting of one or more relational 
expressions separated by the boolean operators and and or. Relational expressions are 
comparisons of two expressions that evaluate to true or false. A relational expression can 
also be a parenthesized conditional expression. 


The relational operators in SQL are shown in Table 4-1. 
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Table 4-1. Relational Operators 


Operator Definition 

= Equal 

<>, !=, /= Not equal 

< Less than 

<= Less than or equal 

> Greater than 

>= Greater than or equal 

like "pattern" String match with pattern 
between low Val and highVal >= lowVal and <= highVal 

in (val1, val2, ...) Equal to one of the specified values 


wom 


The usual relational comparison operators (for example, "=","<", ">") compare the 
results of two expressions. 


The between operation checks that the specified expression returns values inclusively 
within a given range of values. The following query returns the January sales orders. 


select cust_id, ord_num, ord_date from sales_order 
where ord_date between date "1993-1-1" and "1993-1-31"; 


ORD_NUM ORD_DATE 
2201 
2202 
2203 
2204 
2205 
2206 
2207 
2208 
2209 
2210 
2211 1993-01-10 
2212 1993-01-15 
2213 1993-01-16 
2214 
2215 
2216 
2217 


Notice that date constants are encoded according to one of the two following formats. 
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Table 4-2. Date Constant Formats 


1. date "YYYY-MM-DD" 
2. @"YY[YY]-MM-DpD" 


=== 2" 


Format 1 conforms to the emerging SQL2 standard. In this format all four digits of the 
year must be specified. Date "93-1-2" would be January 2, 93 A.D not January 2, 1993. 
Although non-standard, the second format is somewhat more convenient and would 
interpret @"93-1-2" as January 2, 1993. You can change the ordering of the month, day, 
and year fields using the set date default statement. For example, 


set date default to "mm-dd-yyyy"; 


will require date constants to be specified with the year last (for example, date "01-02- 
1993"). 


The in operation evaluates to true when the value of the expression is contained in a 
specified list of values. All customers located in pacific coast states are selected with the 
following statement. 


select cust_id, company, city, state from customer 
where state in ("CA", "OR", "WA"); 


COMPANY CITY STATE 
SEA Seahawks Data Services Seattle WA 
SFF Forty-niners Venture Group San Francisco CA 
LAA Raiders Development Co. Los Angeles CA 
LAN Rams Data Processing, Inc. Los Angeles CA 
SDC Chargers Credit Corp. San Diego CA 


The like operation allows wild-card checking of string expressions: a character in the 
check string matches any single character, and a % in the check string matches zero or 
more characters. The comparison expression must return a string result. The next query 
returns the customers that have "Data" as part of their company name. 


select cust_id, company, city, state from customer 
where company like "SDatas"; 


COMPANY CITY STATE 
SEA Seahawks Data Services Seattle WA 
DAL Cowboys Data Services Dallas TX 
TBB Bucks Data Services Tampa FL 
LAN Rams Data Processing Los Angeles CA 


4.6 Performing Multiple Table Joins 


All of the example queries so far have selected data from a single table. It is often 
necessary to retrieve data from several related tables. To select data from two tables, 
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specify each table name in the from clause and include in the where clause a comparison 
that equates the associated columns (that is, the foreign and primary key columns) from 
the two tables, as shown in the following example that lists each salesperson's customers. 


select sale_name, 


company, 


city; 


state from salesperson, 
where salesperson.sale_id = customer.sale_id; 


customer 


SALE_NAME COMPANY CITY STATE 
Flores, Bob Seahawks Data Services Seattle WA 
Flores, Bob Forty-niners Venture Group San Francisco CA 
Porter, Greg Lions Motor Company Detroit MI 
Stouffer, Bill Colts Nuts & Bolts, Inc. Baltimore IN 
Robinson, Stephanie Raiders Development Co. Los Angeles CA 
Robinson, Stephanie Chargers Credit Corp. San Diego CA 
Robinson, Stephanie Rams Data Processing, Inc. Los Angeles CA 
Kennedy, Bob Broncos Air Express Denver CO 
Kennedy, Bob Cardinals Bookmakers Phoenix AZ 
Wyman, Eliska Browns Kennels Cleveland OH 
Wyman, Eliska Jets Overnight Express New York NY 
Wyman, Bliska Patriots Computer Corp. Foxboro MA 
Wyman, Eliska "Bills We Pay" Financial Corp. Buffalo NY 
Wyman, Eliska Giants Garments, Inc. Jersey City NJ 
McGuire, Sidney Steelers National Bank Pittsburgh PA 
McGuire, Sidney Redskins Outdoor Supply Co. Arlington VA 
McGuire, Sidney Eagles Electronics Corp. Philadelphia PA 
Jones, Walter Chiefs Management Corporation Kansas City MO 
Jones, Walter Bengels Imports Cincinnati OH 
Jones, Walter Bears Market Trends, Inc. Chicago IL 
Warren, Wayne Vikings Athletic Equipment Minneapolis MN 
Warren, Wayne Packers Van Lines Green Bay WI 
Nash, Gail Saints Software Support New Orleans LA 
Nash, Gail Oilers Gas and Light Co. Houston TX 
Nash, Gail Cowboys Data Services Dallas TX 
Williams, Steve Dolphins Diving School Miami FL 
Williams, Steve Falcons Microsystems, Inc. Atlanta GA 
Williams, Steve Bucs Data Services Tampa FL 


Notice that in order to differentiate between the two sale_id columns in the salesperson 
and customer tables it was necessary to prefix the table names to the column names in 
the comparison (for example, salesperson.sale id). 


Recall from Chapter 3 that the comparison used to combine the two tables is called the 
join predicate (for example, salesperson.sale id = customer.sale_id). 


Any number of tables can be joined with a select statement. The next example illustrates 
a three-table join that shows the January sales orders booked by Stephanie Robinson. 


select sale_name, cust_id, ord_date, ord_num, amount 

from salesperson, customer, sales_order 

where salesperson.sale_id = "SWR" and 
salesperson.sale_id = customer.sale_id and 
customer.cust_id = sales_order.cust_id and 


ord_date between date "1993-1-1" and date 


"1993-1-31"; 


SALE_NAME CUST ID ORD_DATE ORD_NUM AMOUNT 

Robinson, Stephanie LAN 1993-01-02 2206 15753.190000 
Robinson, Stephanie LAA 1993-01-16 2214 12614.340000 
Robinson, Stephanie SDC 1993-01-24 2217 705.980000 
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RDS SQL supports left (and right) outer joins through use of the "*=" (or "=*") operator. 
For example, the following select statement will show the customers for all salespersons 
whether or not a particular salesperson has any customers. 


select select sale_name, company, city, state from salesperson, 
where salesperson.sale id *= customer.sale id; 


customer 


The result set will include rows for all salespersons whether or not they have any 
customers. 


4.7 Accessing Tables from Different Databases 


Tables in different databases can be easily joined in a select statement. Simply open both 
databases and formulate the join as described in the last section. The only extra 
information that may need to be supplied is the database name, in the event that both 
databases have a table with the same name. 


The following example gives the descriptions of the specific products ordered in the sales 
orders shown in the last example. 


open sales, invntory; 
select cust id, ord_num, prod id, prod desc 

from customer, sales order, item, product 

where sale id = "SWR" and ord date between @"93-1-1" and @"93-1-31" 
and 


customer.cust_id = sales_order.cust_id and 
sales_order.ord_num = item.ord_num and 
item.prod_id = product .prod_id; 


CUST_ID ORD_NUM PROD_ID PROD_DESC 
LAN 2206 10450 486/50 computer 

LAN 2206 17214 14in VGA monitor 

LAN 2206 15750 750 MB hard disk drive 

LAN 2206 18120 120MB cartridge tape drive 
LAN 2206 18121 120MB tape cartridge 

LAN 2206 23200 enhanced keyboard 

LAN 2206 23400 mouse 

LAA 2214 19100 flat-bed plotter 

LAA 2214 13016 RISC 16MB computer 

LAA 2214 17419 19in SVGA monitor 

LAA 2214 18060 60MB cartridge tape drive 
SDC 2217 22024 1200/2400 baud modem 

SDC 2217 23401 track ball 


Suppose the sales database also had a table named product. The above query would then 
need to be formulated as shown below. 


select cust id, ord num, prod id, prod desc 
from customer, sales order, item, invntory.product 
where sale id = "SWR" and ord date between @"93-1-1" and @"93-1-31" and 
customer.cust_id = sales_order.cust_id and 
sales_order.ord_num = item.ord_num and 
item.prod id = product.prod id; 
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Note that in the from clause the product table is prefixed with the database name 
invntory. Also note that the prod_id in the select column list is not qualified. Unqualified 
duplicate column names will be assumed to be from the first table in the from list that 
contains a column with that name. 


If two tables with the same name in separate databases need to be referenced in the same 
statement, correlation names need to be supplied in the from clause to distinquish between 
the two table references. Correlation names are aliased identifiers that are specified 
following the table name. Suppose that the product table in the inventory database was 
named item instead of product. The last example would then need to be specified as 
follows: 


select cust_id, ord_num, prod_id, prod_desc 
from customer, sales_order, sales.item s_item, invntory.item i_item 
where sale_id = "SWR" and ord_date between @"93-1-1" and @"93-1-31" and 
customer.cust_id = sales_order.cust_id and 
sales order.ord num = item.ord_num and 
s item.prod id = i item.prod id; 


The correlation name for the sales database item table is 8 item and the correlation name 
for the inventory database item table is i item. Columns from their respective tables are 
qualified using the correlation names. 
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Chapter 5 
Computational Queries 


5.1 Introduction 


This chapter describes the computational capabilities of the SQL select statement, 
including how to: 


e Perform arithmetic calculations on database columns 

e Perform summary calculations on grouped information 
e Use RDS SQL's built-in functions 

e Conditionally select column results 


5.2 Basic Expression Evaluation 


The queries shown in the last chapter retrieved only base columns from the selected 


tables. SQL also allows you to select column values that are the result of an expression. 


The sales order table contains a column called amount that contains the total amount of 
the order and a column called tax containing the sales tax, if any. The following query 


will display the invoice amount that is the sum of the two columns. 
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select cust_id, ord_date, amount, tax, amount+tax from sales_order; 


CUST ID ORD DATE AMOUNT TAX AMOUNT+TAX 
CH 1993-01-02 46740.000000 4113.120000 50853.120000 
MIN 1993-01-02 25915.860000 1840.030000 27755.890000 
KCC 1993-01-02 19567.080000 978.350000 20545.430000 
CIN 1993-01-02 2733.280000 0.000000 2733.280000 
BUF 1993-01-03 150871.200000 12069.700000 162940.900000 
LAN 1993-01-02 15753.190000 1417.790000 17170.980000 
DEN 1993-01-06 274375.000000 17011.250000 291386.250000 
PHI 1993-01-07 3437.500000 0.000000 3437.500000 
PHO 1993-01-07 3715.830000 0.000000 3715.830000 
IND 1993-01-09 8780.000000 0.000000 8780.000000 
GBP 1993-01-10 53634.120000 0.000000 53634.120000 
ATL 1993-01-15 12569.750000 817.030000 13386.780000 
NYG 1993-01-16 7895.000000 0.000000 7895.000000 
LAA 1993-01-16 12614.340000 1135.290000 13749.630000 
SEA 1993-01-17 16892 .000000 1435.820000 18327.820000 
KCC 1993-01-21 7847.510000 392.380000 8239.890000 
SDC 1993-01-24 705.980000 63.540000 769.520000 
NOS 1993-01-24 81375.000000 0.000000 81375.000000 
DET 1993-01-27 74034.900000 0.000000 74034.900000 
DEN 1993-01-27 49980.000000 3098.760000 53078.760000 
NEP 1993-01-27 13235.340000 992.650000 14227.990000 
1993-01-28 1877.030000 .000000 1877.030000 


RDS SQL allows you to add, subtract, multiply, and divide columns and constants. 
Arithmetic expressions can be parenthesized in the usual manner. The following table 
shows the evaluation precedence of the arithmetic expression operators in order of 
highest to lowest. Operators at the same precedence level evaluate from left to right. 


Table 5-1. Arithmetic Operator Precedence 


Operator Definition 

() parenthetical expressions 
+,- unary plus or minus (sign) 
“ah multiply and divide 

+,- add and subtract 


p 
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The next query shows the salespersons’ orders with the largest earned commissions. The 
select statement computes the commission earned by multiplying the commission rate by 
the amount of the order. The salesperson's name is accessed by using a three-table join 
between the salesperson, customer, and sales_order tables. Finally, the result is sorted 
in descending order by the earned commission. 


select sale_name, ord_num, amount*commission 
from salesperson, customer, sales order 

where salesperson.sale id = customer.sale id 
and customer.cust id = sales order.cust id 


order by 3 desc; 


SALE NAME ORD NUM AMOUNT*COMMISSION 
Porter, Greg 2288 20193.999549 
Kennedy, Bob 2207 19206.250082 
Wyman, Eliska 2205 10560.984045 
Kennedy, Bob 2253 10036.250043 
Robinson, Stephanie 2234 8726.200037 
Flores, Bob 2284 7431.516111 
Nash, Gail 2324 7281.365031 
Kennedy, Bob 2237 7271.236031 
Porter, Greg 2250 6594.467853 
Porter, Greg 2219 5922.791868 
Jones, Walter 2241 5762.050025 
Nash, Gail 2218 5696.250024 
Warren, Wayne 2292 5407.325023 
Wyman, Eliska 2281 4643.905020 
Jones, Walter 2257 4363.800019 
Williams, Steve 2230 4363.800019 
Wyman, Eliska 2270 3841.250016 
Nash, Gail 2226 3841.250016 


The previous query showed how much the salesperson gets from each order. The next 
query shows how much the company gets from each order. The amount to the company 
is simply the order amount minus the commission. The following query produces the 
desired results. Note that you can provide an alternate heading for a column as with 
"NET REVENUE". The alternate heading can be specified as a string or an identifier. 
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select sale_name, ord_num, amount-amount*commission "NET REVENUE" 
from salesperson, customer, sales_order 
where salesperson.sale_id = customer.sale_id 
and customer.cust_id = sales_order.cust_id 

order by 3 desc; 


SALE_NAME ORD_NUM NET REVENUE 
Kennedy, Bob 2207 255168.749918 
Porter, Greg 2288 232231.000451 
Wyman, Eliska 2205 140310.215955 
Kennedy, Bob 2253 133338.749957 
Robinson, Stephanie 2234 115933.799963 
Nash, Gail 2324 96738.134969 
Kennedy, Bob 2237 96603 .563969 
Jones, Walter 2241 76552.949975 
Porter, Greg 2250 75836.382147 
Nash, Gail 2218 75678.749976 
Warren, Wayne 2292 71840.174977 
Porter, Greg 2219 68112.108132 
Flores, Bob 2284 66883 .643889 
Wyman, Eliska 2281 61697.594980 
Jones, Walter 2257 57976.199981 
Williams, Steve 2230 57976.199981 
Wyman, Eliska 2270 51033.749984 
Nash, Gail 2226 51033.749984 
Warren, Wayne 2211 49879.731584 
Kennedy, Bob 2220 46481.399985 
Jones, Walter 2271 46113.724485 
McGuire, Sidney 2290 44054.099986 


5.3 Grouped Calculations 


All select statements in this chapter have generated detail rows, that is, there is one line of 
output for each row selected. Although this is usually adequate for the information you 
are selecting, you often want to summarize a number of similar records into a single row. 
RDS SQL uses the select statement group by clause to summarize the selected 
information. The data is arranged based on the columns specified in the group by 
clause; one row is returned each time one of the listed columns changes value. 


The set of rows of similar records on which the group by summary is performed is 
known as an aggregate. The functions described below perform their calculations on 
aggregates. 


In addition to the arithmetic operators you saw earlier in this chapter, RDS SQL has 
calculation functions that perform computations on aggregates. Table 5-2 lists the QUERY 
calculation functions. 
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Table 5-2. Calculation Functions 


Computes the sum of the results of the specified 
expression for each row of the aggregate. 


sum([distinct] expr) 


avg([distinct] expr) Computes the average of all rows of the aggregate. 
count([distinct] {colname | *}) Counts the number of rows in the aggregate. 


max(expr) Computes the maximum of the results of the 


specified expression for all rows of the aggregate. 


An aggregate is specified with the group by clause of the select statement. Suppose you 
wanted to see the year-to-date earnings for each salesperson. The following example 
shows how grouped calculations are used to formulate a select statement that will 
produce the desired information. All orders for each salesperson are summarized and 
the total amount of all orders is computed as is the total commissions. 


Computes the minimum of the results of the 
specified expression for all rows of the aggregate. 


select sale_name, sum(amount), sum (amount *commission) 
from from salesperson, customer, sales order 
where salesperson.sale id = customer.sale id 
and customer.cust id = sales order.cust id; 
group by sale name; 


SALE NAME SUM (AMOUNT) SUM (AMOUNT* COMMISSION) 
Flores, Bob 173102 .020000 17310.202258 
Jones, Walter 422560.550000 29579 .238626 
Kennedy, Bob 736345.320000 51544.172619 
McGuire, Sidney 208432.110000 14590.247762 
Nash, Gail 306807.260000 21476.508291 
Porter, Greg 439346.500000 35147.719214 
Robinson, Stephanie 374904.470000 26243-313012 
Stouffer, Bill 29053.300000 2324.263948 
Warren, Wayne 212638.500000 14884.695063 
Williams, Steve 247179.990000 17302.599374 
Wyman, Eliska 566817.010000 39677 .190869 


Figure 5-1 shows how the orders for Bob Flores comprise the aggregate from which the 
summary is produced that totals the amount and amount+tax columns. 
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SALE_NAME AMOUNT AMOUNT+TAX 
Flores, 16892 .000000 18327.820000 
Flores, Bob 2987.500000 3241.440000 
Flores, Bob 8824.560000 9574.650000 
Flores, Bob 1365.800000 1481.890000 


aggregate | Flores, Bob 650.000000 705.250000 
Flores, Bob 30036.500000 32589.600000 
Flores, Bob 74315.160000 81003.520000 
Flores, Bob 13040.500000 14214.150000 
Flores, Bob 24990.000000 27239.100000 


sum(amount) sum(amount+tax) 
summary y y 
Flores, Bob 173102.020000 188377.420000 


Figure 5-1. How Group By Works 


| The output from the queries produced so far has been shown in the default display 
format for each data type. For example, the default format for columns of type float 
displays results with six decimal places. You can use the convert function to convert an 
expression to a character string according to a specified format. The next example shows 
the effect of the convert function on the previous query. Also note that identifiers are 
used to rename the columns (for example, total_amt). 


select sale_name, convert (sum(amount),char(12),"#,#.##") total_amt, 
convert (sum(amount*commission),char(12),"#,#.##") total_comm, 
from acct_sale group by sale_name; 


SALE_NAME TOTAL_AMT TOTAL COMM 
Flores, Bob $173,102.02 $17,310.20 
Jones, Walter $422,560.55 $29,579.24 
Kennedy, Bob $736,345.32 $51,544.17 
McGuire, Sidney $208,432.11 $14,590.25 
Nash, Gail $306,807.26 $21,476.51 
Porter, Greg $439,346.50 $35,147.72 
Robinson, Stephanie $374,904.47 $26,243.31 
Stouffer, Bill $29,053.30 $2,324.26 
Warren, Wayne $212,638.50 $14,884.70 
Williams, Steve $247,179. $17,302.60 
Wyman, Eliska $566,817. $39,677.19 


If you do not specify a group by clause, all of the resulting rows comprise the aggregate. 
The next query computes the total year-to-date sales. 
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set float display (14, "S#,#.##"); 


select sum(amount) from sales_order; 


SUM (AMOUNT ) 
$3,717,187.03 


The above set statement specifies the default display format for all columns of type float. 
It can be used as an alternative to the convert function. Use of the convert function 
overrides the default display format. Most of the remaining examples use the above 
specified format for floating point values (only the columns used to store monetary 
amounts are of type float in the example databases). 


If you are starting to tire of having to enter all of the join predicates for the salesperson - 
sales order queries, you can simplify the process by creating a view that selects the 
needed columns from the joined tables. In the following example, a view called 

acct sale is defined. Views are defined using a create view statement and associating a 
select statement with the named view. The defined view can then be used just like you 
would use any table except now you don't have to enter all of the join predicates. Views 
are described in more detail in Chapter 8, "Using Views." 


Besides showing the view definition, the example below also illustrates the use of the avg 
calculation function. The results show the average amount and average earned 
commission for each order processed by each salesperson. 


create view acct sale 
as select sale name, commission, amount 
from salesperson, customer, sales order 
where salesperson.sale id = customer.sale id 
and customer.cust id = sales order.cust id; 


select sale name, avg (amount), avg (amount *commission) 
from acct sale group by sale name 


SALE NAME AVG (AMOUNT) AVG (AMOUNT*COMMISSI ON) 
Flores, Bob $19,233.56 $1,923.36 
Jones, Walter $28,170.70 $1,971.95 
Kennedy, Bob $61,362.11 $4,295.35 
McGuire, Sidney $18,948.37 $1,326.39 
Nash, Gail $34,089.70 $2,386.28 
Porter, Greg $87,869.30 $7,029.54 
Robinson, Stephanie $24,993.63 $1,749.55 
Stouffer, Bill $3,631.66 $290.53 
Warren, Wayne $21,263.85 $1,488.47 
Williams, Steve $27,464.44 $1,922.51 
Wyman, Eliska $23,617.38 $1,653.22 


The count function is used to calculate the number of detail rows from which the 
aggregate is comprised. The next query shows the number of orders placed by each 
customer. 
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select company, count (ord num) from customer, sales_order 
where customer.cust_id = sales_order.cust_id group by 1; 


COMPANY COUNT (ORD_NUM) 
"Bills We Pay" Financial Corp. 
Bears Market Trends, Inc. 
Bengels Imports 
Broncos Air Express 
Browns Kennels 
Bucs Data Services 
Cardinals Bookmakers 
Chargers Credit Corp. 
Chiefs Management Corporation 
Colts Nuts & Bolts, Inc. 
Cowboys Data Services 
Dolphins Diving School 
Eagles Electronics Corp. 
Falcons Microsystems, Inc. 
Forty-niners Venture Group 
Giants Garments, Inc. 
Jets Overnight Express 
Lions Motor Company 
Oilers Gas and Light Co. 
Packers Van Lines 
Patriots Computer Corp. 
Raiders Development Co. 
Rams Data Processing, Inc. 
Redskins Outdoor Supply Co. 
Saints Software Support 
Seahawks Data Services 
Steelers National Bank 

ikings Athletic Equipment 


ANA WIR OI TIR W VULUS NWVUNWOUVWUVIRISIUUV 


The argument to count can be any of the column names or, since it really doesn't matter 
which column you choose to count (they all give the same result), you can simply write 
count(*). 
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The following example shows the total number of orders in the system along with the 
minimum, maximum, and average order amounts. 


select count(*), min (amount) 


, Max(amount), avg(amount) from sales_order; 


COUNT (*) MIN (AMOUNT) MAX (AMOUNT) AVG (AMOUNT) 
127 $68.75 $274,375.00 $29,269.19 


Sometimes one of the columns in an aggregate has duplicate values. If you do not want 
the duplicates included in the aggregate calculation, you can specify distinct. Use of 
distinct is shown in the following query which gives both the total number of items sold 
by each salesperson and the total number of distinct products sold by each salesperson. 


select sale_name, count (prod id), count (distinct prod id) 
from salesperson, Customer, sales order, item 
where salesperson.sale id = customer.sale id and 
customer.cust id = sales order.cust id and 
sales order.ord num = item.ord num 
group by 1; 


SALE NAME COUNT (PROD ID) COUNT (DISTINCT PROD ID) 
Flores, Bob 

Jones, Walter 

Kennedy, Bob 

McGuire, Sidney 

Nash, Gail 


Porter, Greg 
Robinson, Stephanie 
Stouffer, Bill 
Warren, Wayne 
Williams, Steve 
Wyman, Eliska 


The distinct option can only be specified in a count, sum, or avg function. 
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You cannot use a where clause to restrict the output rows based on calculated results. 
SQL provides an additional clause, called having, for restricting rows based on aggregate 
functions. In the example below, the having clause selects only the results from those 
companies that have more than five orders for the year. 


select company, count (ord num), sum (amount) from purchases 
group by company having count (ord num) > 5; 


COMPANY COUNT (ORD NUM 
Broncos Air Express 

Browns Kennels $43,284.54 
Colts Nuts & Bolts, Inc. $29,053.30 


) SUM (AMOUNT ) 
7 
7 
8 
Patriots Computer Corp. 6 $120,184.69 
8 
6 
6 


$498,952.76 


Rams Data Processing, Inc. $172,936.31 
Seahawks Data Services $60,756. 
Vikings Athletic Equipment $49,461. 


If you had put count(ord_num) > 5 in the where clause, the system would have returned 
an error. Calculation functions cannot be specified in the where clause. The where 
clause is used to restrict detail rows before they affect the summary calculations. The 


having clause is used to restrict aggregate result rows after the calculations have been 
performed. 


The query in the next example shows the salespersons who had more than $50,000 in 
sales during the month of June. 
select sale name, sum(amount) from acct sale 
where ord date between date "06-01-1993" and date "06-30-1993" 
group by sale name having sum(amount) > 50000.00; 


SALE NAME SUM (AMOUNT) 


Flores, Bob $55,026. 
McGuire, Sidney $72,541. 
Nash, Gail $104,019. 
Robinson, Stephanie $58,970. 
Williams, Steve $52,569. 
Wyman, Eliska $103,076. 


Figure 5-2 shows how a where clause is used to filter out detail rows before the 
calculations are performed and how a having clause filters out calculation results. 
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SALE_NAME ORD_DATE AMOUNT 
Flores, Bob 01-17-1992 16892 .000000 
lores, Bob 01-29-1992 2987.500000 
lores, Bob 02-04-1992 8824.560000 
Bob 03-23-1992 1365.800000 
Bob 04-03-1992 650.000000 
Bob 06-05-1992 30036.500000 
Bob 04-20-1992 74315.160000 
Bob 05-19-1992 13040.500000 
Bob 06-19-1992 24990.000000 
Greg 01-27-1992 74034.900000 
Greg 03-06-1992 82430.850000 
Porter, Greg 04-24-1992 252425.000000 
Porter, Greg 05-14-1992 2673.750000 
Porter, Greg 06-24-1992 27782.000000 


where ord_date between date “06-01-1992” and date “06-30-1992” 


SALE_NAME ORD_DATE AMOUNT 
Flores, Bob 06-05-1992 30036.500000 
Flores, Bob 06-19-1992 24990.000000 
Porter, Greg 06-24-1992 27782.000000 


select sale_name, sum(amount) group by 1 


SALE_NAME SUM (AMOUNT) 
Flores, Bob 55026.500000 
Porter, Greg 27782.000000 


having sum(amount) > 50000.0 


SALE_NAME SUM (AMOUNT) 
Flores, Bob 55026.500000 


Figure 5-2. Operation of Where and Having Clauses 
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5.4 Using Built-in Functions 


You have already been introduced to one of the RDS SQL built-in functions, convert. 
RDS SQL has many built-in functions that you can use to perform a variety of operations. 
These built-in functions are often called scalar functions to differentiate them from the 
aggregate functions described in the last section. Scalar functions operate on a single 
value and return a single value. Aggregate functions operate on multiple values and 
return a single value. 


RDS SQL provides four classes of built-in functions as follows: 


e numeric functions (for example, sin, cos, mod, log) 
e string functions (for example, concat, substring, length) 
e date functions (for example, dayofweek, month) 


e system functions (for example, user, database) 
A complete list of all of the RDS SQL built-in functions is provided in Table 5-3. If the 
functions you need are not available, you can define your own functions in C and have 
them called from RDS SQL when referenced in SQL statements. Chapter 10, "Stored 
Procedures and User-Defined Functions," provides some examples. The RDS 
SQL C Programmer's Guide contains detailed information that will show you how to write 
your own functions. 


Table 5-3. RDS SQL Built-in Functions Table 


Returns the arccosine of expr (must be 
between -1.0 and +1.0) in radians (that is, 
between 0 and pi). 

age(date_expr) Calculates the age (based on the current date) 
of date_expr (usually, a birthdate). 

ascii(str) Returns the ASCII numeric value of the initial 
character in str. 
Returns the arcsine of expr (must be between 
-1.0 and +1.0) in radians.. 
Returns the arctangent of expr (must be 
between -1.0 and +1.0) in radians.. 
Returns the arctangent of the specified x and 
y coordinates (each must be between -1.0 and 
+1.0) in radians.. 

(Continued) 
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(Continued) 


Returns the smallest integer that is greater 
than or equal to expr. 


Returns the character that has the ASCII code 
value of num where num is between 0 and 
255. 

Returns str concatenated to strj. (Same as 
using the ^ operator). 
Converts expr to the specified data type. If 
type is char, then 1) len value specifies the 
length of the resulting string, and 2) an 
optional format specifier can be specified. 


curtime() 


database() Returns a string containing the name(s) of the 
database(s) that the session has open. If more 
than one database is open, the names are 

separated by commas with no intervening 


spaces (for example, "sales,invnto 


Returns the exponential function of expr (that 
is, PM), 

Returns the largest integer that is less than or 
equal to expr. 


(Continued) 
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(Continued) 


hour(time_expr) Returns the hour in time_expr (either a time 
or timestamp value) as a number between 0 
and 23. 
If expr] (a conditional expression) is true, 
expr is returned. If expr is false, expr3 is 
returned. Both exprz and expr3 must be 
compatible data types. 
If expr is null, exprg is returned. If expry is 
not null, expr, is returned. Both exprs must 
be compatible data 
Returns the string that results from replacing 
num) characters beginning at position num 
(first character is position 1, not 0) in stry with 
stro. 


Icase(str) Converts str to lower case. 
left(str, num) Returns the leftmost num characters from str. 
p Returns the length of str. 


Returns the character position in str where a 
string matching str; begins. The search is 
made beginning at character position num in 
stro. Returns 0 if str, is not found in strz. 
log(expr) sid Returns the natural logarithm of expr. 
ltrim(str) Returns the string that results from removing 
all leading spaces from str. 

Returns the minute in time_expr (either a time 
or timestamp value) as a number between 0 


if(expr 1, expr, expr3) 


ifnull(expr1, expr2) 


insert(strj, numq, num, str?) 


locate(strj, stra, num) 


minute(time_expr) 


mod(expr, expr Returns expr; modulo expr» (that is, the 
pr, €Xpr2 Pry pr2 


remainder that results from dividing expr by 


). 

Returns the number of the month in 
date_expr as a number between 1 and 12. 

Returns timestamp value for the current date 
and time. 


Returns the value of pi as a double (3.14159...) 


(Continued) 
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(Continued) 


Returns the number of the quarter in 

date_expr as a number between 1 and 4. 
Returns a random floating point number 
(between 0 and 1) with integer num as the 


seed. If num is zero then the next random 
number for the current seed is returned. 


repeat(str, num) Returns the string that results from 
concatenating str to itself num -1 times. 


replace(str1, strz, str3) Returns the string that results from replacing 
all occurrences of str in str; with str3. 
Returns str] if str» is not in str. 

Returns the rightmost num characters from 
str. 

rtrim(str) Returns the string that results from removing 
all trailing spaces from str. 

Returns the second in time_expr (either a time 
or timestamp value) as a number between 0 
and 59. 


ee 
equals 0, and 1 if expr is greater than 0. 


jamal cage 
begins in character position num, of str. 
Converts str to upper case. 
week(date_expr) Returns the number of the week of the year in 
date_expr as a number between 1 and 53. 


year(date_expr) Returns the year in date_expr. The earliest 
ear for an RDS SQL date is 1 A.D. 


quarter(date_expr) 


rand(num) 


right(str, num) 


second(time_expr) 
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The example select statement below calls function dayofweek to show the distribution of 
sales orders based on the day of the week that the order was placed. The function 
returns a value between 1 and 7, where 1 represents Sunday. 


select dayofweek (ord date), count (*) from sales_order group by 1; 


DAYOFWEEK (ORD_DATE) COUNT (* ) 


2 
3 
4 
5 
6 


You can use function convert to format a result so that it is easier for users to read. The 
"dddd" format indicates that the full spelling of the day is to be returned. Had "ddd" 
been specified, the three-character day-of-week abbreviation would have been returned. 


select convert (dayofweek(ord date), char(10), "dddd") "DAY OF ORDER", 
count (*) from sales order group by 1; 


DAY OF ORDER COUNT (*) 


The following query calls function month to return the month number from the order 
date and compute the sales totals for each month. 


select month(ord date), sum(amount) from sales order group by 1; 


MONTH (ORD DATE) SUM (AMOUNT) 
1 $969,467. 
2 $529,401. 
3 $415,894. 
4 $953,985). 
5 $249,299. 
6 $599,138. 


The following examples illustrate some of the string manipulation functions available in 
RDS SQL. 


The next example uses functions ucase (convert string to upper case) and substring to 
find all customers who have a customer id equal to the first three characters of the 
company name. 


select cust_id, company from customer 
where cust_id = ucase (substring (company, 1,3)); 


CUST ID COMPANY 
SEA Seahawks Data Services 


The concat function is used to concatenate strings as shown in the following query. 


5-16 Raima Database Server SQL Language Guide 


select sale_name, 
concat (city, concat(", ", concat (state, concat(" ", Zip)))) locality 
from accounts; 


SALE_NAME LOCALITY 

Flores, Bob Seattle, WA 98121 
Flores, Bob San Francisco, CA 94127 
Porter, Greg Detroit, MI 48243 
Stouffer, Bill Baltimore, IN 46219 
Robinson, Stephanie Los Angeles, CA 92717 
Robinson, Stephanie San Diego, CA 92126 
Robinson, Stephanie Los Angeles, CA 90075 
Kennedy, Bob Denver, CO 80239 
Kennedy, Bob Phoenix, AZ 85021 
Wyman, Eliska Cleveland, OH 44115 
Wyman, Eliska New York, NY 10021 
Wyman, Eliska Foxboro, MA 02131 
Wyman, Eliska Buffalo, NY 14216 
Wyman, Eliska Jersey City, NJ 07749 
McGuire, Sidney Pittsburgh, PA 15234 
McGuire, Sidney Arlington, VA 22206 
McGuire, Sidney Philadelphia, PA 19106 
Jones, Walter Kansas City, MO 64141 
Jones, Walter Cincinnati, OH 45241 
Jones, Walter Chicago, IL 60603 
Warren, Wayne Minneapolis, MN 55420 
Warren, Wayne Green Bay, WI 54304 
Nash, Gail New Orleans, LA 70113 


Use of the concat function in the last example requires several recursive calls to construct 
the customer locality string. You can alternatively use the string concatenation operator, 
^, to more easily achieve the desired result as shown below. 


select sale name, city ^ ", " ^ state ^" »" ^ zip from accounts; 


5.5 Conditional Column Selection 


So far, you have seen how to conditionally select information using the where and 
having clauses. These clauses restrict the rows to be included in the result set. This 
section introduces you to the if function, which lets you conditionally select alternative 
column results. 


The if function lets you select an expression based on a specified condition applied to 
each resultant row of the select statement. The syntax for the if function is: 


if ( cond_expr , expression, expression 


If the conditional expression (cond_expr) evaluates to TRUE, the function evaluates and 
returns the value of the first expression. If cond_expr evaluates to FALSE, the if function 
evaluates and returns the value of the second expression. 
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The if function's power is illustrated in the next example, which shows in a column 
format the total sales of selected computer types closed by each salesperson. 


set float display(10, 
select sale_name, 
sum(if(i prod id=10320,amount,0.0)) "3/20 SALES", 
sum(if(i prod id=10333,amount,0.0)) "3/33 SALES", 
sum(if(i prod id=10433,amount,0.0)) "4/33 SALES", 
sum(if(i prod id=10450,amount,0.0)) "4/50 SALES" 
from salesperson, customer, sales order, item 
where salesperson.sale id = customer.sale id and 
customer.cust id = sales order.cust id and 
sales order.ord num = item.ord num 
group by sale name; 


SH HET); 


SALE_NAME 3/20 SALES 3/33 SALES 4/33 SALES 4/50 SALES 
Flores, Bob $0.00 $74315.16 $74315.16 $0.00 
Jones, Walter $0.00 $21252::72 $76999.24 $15998.13 
Kennedy, Bob $0.00 $0.00 $10543.79 $0.00 
McGuire, Sidney $0.00 $0.00 $7129.20 $37408.52 
Nash, Gail $22137.36 $0.00 $0.00 $0.00 
Porter, Greg $0.00 $0.00 $0.00 $0.00 
Robinson, Stephanie $0.00 $50364.77 $8765.37 $33152.59 
Stouffer, Bill $0.00 $11609.37 $0.00 $0.00 
Warren, Wayne $25915.86 $53634.12 $46190.63 $24103.30 
Williams, Steve so. $0.00 $0.00 $16986.99 
Wyman, Eliska $9811. .72 $3403.98 $25002.78 
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Chapter 6 


Nested Queries 
Enkle Sail EJ 


6.1 Introduction 


Traditional Programming languages such as C, Pascal, and COBOL are in a class of 
languages called procedural programming languages. These languages all contain 
statements that can control the order in which statements are executed. Programs in a 
procedural language may require that several statements be executed to achieve the 
desired result. SQL, on the other hand, is in a class of languages called non-procedural. 
Statements in a non-procedural language are generally much more powerful than those 
typically found in their procedural counterparts. A single SQL select statement can 
perform what could take many statements to do in a procedural database language. 
Much of the non-procedural capabilities in SQL are provided through nested query (or 
subquery) evaluation features. 


Subqueries allow SQL statements to restrict where clause results based on the evaluated 
result of a select statement nested within the SQL statement. This chapter will introduce 
you to the nested query capabilities of the select statement, including the following: 


e simple, single-valued subquery evaluation 
e multiple-valued subquery evaluation 
e complex, correlated subquery evaluation 


6.2 Single-Valued Subqueries 


The subquery that is the simplest and most often used is one that returns a single value 
that is used in a comparison in the where clause. 


Single-valued subqueries have the following form: 


select ... from ... where expr relop (select expr from ... 


where relop is one of the standard relational comparison operators (=,<,>,<=,>=,<>). 
Note that only one column expression can be specified in a subquery. Subqueries that 
select more than one column expression will be rejected. 


The value returned by single-valued subqueries is often computed from one of the 
aggregate calculation functions (sum, count, avg, min, and max). 
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The following example returns the customer orders with order amounts that are larger 
than the average sales order. 


select company, amount from customer, sales_order 
where customer.cust_id = sales_order.cust_id and 
amount > (select avg(amount) from sales order); 


COMPANY AMOUNT 
Seahawks Data Services 30036.500000 
Raiders Development Co. 124660.000000 
Broncos Air Express 274375.000000 
Broncos Air Express 49980.000000 
Broncos Air Express 103874.800000 
Saints Software Support 81375.000000 
Saints Software Suppor 104019.500000 
Rams Data Processing, Inc. 39506.970000 
Rams Data Processing, Inc. 29977.700000 
Chiefs Management Corporation 82315.000000 
Bengels Imports 62340.000000 
Oilers Gas and Light Co. 54875.000000 
Jets Overnight Express 32925.000000 
Jets Overnight Express 54875.000000 
Patriots Computer Corp. 66341.500000 


"Bills We Pay" Financial Corp. 150871.200000 
"Bills We Pay" Financial Corp. 46091.440000 
Forty-niners Venture Group 74315.160000 
Cowboys Data Services 30089.500000 
Cardinals Bookmakers 143375.000000 
Cardinals Bookmakers 35119.460000 
Cardinals Bookmakers 38955.000000 


Redskins Outdoor Supply Co. 47309.940000 


Subqueries can be nested within other subqueries. The next example uses two nested 
subqueries to show the orders by salesperson that are larger than the largest order that 
closed after the last order closed in New Jersey. 


select sale name, 
sales order 
where salesperson.sale id = customer.sale id and 
customer.cust id = sales order.cust id and 
amount > (select avg(amount) from sales order 
where ord date > (select max (ord date) from 
sales order, customer where state = "NJ" and 
sales order.cust id = customer.cust id)); 


amount, ord date from salesperson, customer, 


SALE NAME AMOUNT ORD DATE 
Flores, Bob 30036.500000 1993-06-05 
Flores, Bob 74315.160000 1993-04-20 
Porter, Greg 74034.900000 1993-01-27 
Porter, Greg 82430.850000 1993-03-06 
252425.000000 1993-04-24 
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6.3 Multi-Valued Subqueries 


Subqueries can also return more than one value. Multi-valued subqueries are formulated 
as follows: 


select ... from ... where expr relop {any | all} (select expr from ... 


or 


select ... from ... where expr [not] in (select expr from ... 


In subqueries of the first form a quantifier is used to determine whether the relational 
operation applies to all rows or to any (at least 1) row from the result set (some can be 
used instead of any, if desired). 


For example, the following query will return the customer orders with amounts that are 
larger than all of the orders booked in May. 


select company, ord_num, ord_date, amount from customer, 
where customer.cust_id = sales_order.cust_id and 
amount > all (select amount from sales_order where 
ord_date between date "1993-05-01" and date "1993-05-31"); 


sales_order 


COMPANY ORD_NUM ORD_DATE AMOUNT 
Raiders Development Co. 2234 1993-02-10 124660.000000 
Broncos Air Express 2207 1993-01-06 274375.000000 
Broncos Air Express 2220 1993-01-27 49980.000000 
Broncos Air Express 2237 1993-02-12 103874.800000 
Saints Software Support 2218 1993-01-24 81375.000000 
Saints Software Support 2324 1993-06-30 104019.500000 
Chiefs Management Corporation 2241 1993-02-21 82315.000000 
Bengels Imports 2257 1993-03-23 62340.000000 
Oilers Gas and Light Co. 2226 1993-01-30 54875.000000 
Jets Overnight Express 2270 1993-04-02 54875.000000 
Patriots Computer Corp. 2281 1993-04-13 66341.500000 
"Bills We Pay" Financial Corp. 2205 1993-01-03 150871.200000 


"Bills We Pay" Financial Corp. 2317 1993-06-18 46091.440000 
Forty-niners Venture Group 2284 1993-04-20 74315.160000 
Cardinals Bookmakers 2253 1993-03-16 143375.000000 
Redskins Outdoor Supply Co. 2310 1993-06-04 7309.940000 
Falcons Microsystems, Inc. 2230 1993-02-04 62340.000000 
Bears Market Trends, Inc. 2201 1993-01-02 46740.000000 
Bears Market Trends, Inc. 2271 1993-04-03 49584.650000 
Lions Motor Company 2219 1993-01-27 74034.900000 
Lions Motor Company 2250 1993-03-06 82430.850000 
Lions Motor Company 2288 1993-04-24 252425.000000 
Packers Van Lines 2211 1993-01-10 53634.120000 
Packers Van Lines 2292 1993-04-30 77247 .500000 


Eagles Electronics Corp. 2290 1993-04-29 47370.000000 
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Subqueries of the second form are simply a different way of writing those of the first 
form. Thus, "expr in (select ...)" is the same as "expr = any (select ...)" and "expr not in 
(select ...)" is the same as "expr <> all (select ...)". The following example 
demonstratestwo ways to show the customers who are located in states that also have a 
sales office. 


select company, city, state from customer 
where state = any (select state from outlet); 


or 


select company, city, state from customer 
where state in (select state from outlet); 


COMPANY CITY STATE 
Seahawks Data Services Seattle WA 


Raiders Development Co. Los Angeles CA 
Broncos Air Express Denver CO 
Chargers Credit Corp. San Diego CA 
Rams Data Processing, Inc. Los Angeles CA 
Chiefs Management Corporation Kansas City MO 
Oilers Gas and Light Co. Houston TX 
Jets Overnight Express New York NY 
Patriots Computer Corp. Foxboro MA 
"Bills We Pay" Financial Corp. Buffalo NY 
Forty-niners Venture Group San Francisco CA 
Cowboys Data Services Dallas TX 
Falcons Microsystems, Inc. Atlanta GA 
Vikings Athletic Equipment Minneapolis MN 
Bears Market Trends, Inc. Chicago IL 


select company, city, state from customer 
where state <> all (select state from outlet); 


COMPANY 

Saints Software Support 
Bengels Imports 

Browns Kennels 

Steelers National Bank 
Dolphins Diving School 
Colts Nuts & Bolts, Inc. 
Giants Garments, Inc. 
Cardinals Bookmakers 


Redskins Outdoor Supply Co. 


Lions Motor Company 
Packers Van Lines 

Bucs Data Services 
Eagles Electronics Corp. 


CITY 

New Orleans 
Cincinnati 
Cleveland 
Pittsburgh 
Miami 
Baltimore 
Jersey City 
Phoenix 
Arlington 
Detroit 
Green Bay 
Tampa 
Philadelphia 
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6.4 Correlated Subqueries 


Sometimes, a subquery needs to refer to a column from the outer query. These column 


references are called outer references and subqueries that contain them are called correlated 
subqueries. 


The following query retrieves the customers who are located in cities that also have an 
outlet. 


select company, city, state from customer 
where city in (select city from outlet where 
outlet.state = customer.state); 


COMPANY CITY STATE 
Seahawks Data Services Seattle WA 
Raiders Development Co. Los Angeles CA 
Broncos Air Express Denver CO 
Rams Data Processing, Inc. Los Angeles CA 
Chiefs Management Corporation Kansas City MO 
Cowboys Data Services Dallas TX 
Falcons Microsystems, Inc. Atlanta GA 
Vikings Athletic Equipment Minneapolis MN 
Bears Market Trends, Inc. Chicago IL 


This query selects those rows from the inner query that have the same state as the outer 
query. The inner query references the state column from the outer query by including 
the outer query's table name. 


Correlated subqueries are evaluated by executing the inner query for each row of the 
outer query. Thus, the processing time required to execute a correlated subquery can 
sometimes be quite long. Alternative processing methods can sometimes be devised 
through the creation of temporary tables and indexes to hold intermediate results which 
can then be joined with the select statement that returns the desired information. 


The next example returns order amounts for salespersons that are greater than the 


average order for their departments. A department is composed of those salespersons 
who have the same manager. 
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amount > 
where sp2.mgr_id 


select sale_name, 
spl, customer, sales order 
salesperson.sale id = customer.sale id and 
customer.cust id = sales order.cust id and 
(select avg(amount) 
spl.mgr id); 


mor id, amount from salesperson 
where mar id is not null and 


from salesperson sp2, customer, sales order 


6-6 


SALE NAME 
Robinson, 
Kennedy, Bob 
Kennedy, Bob 
Kennedy, Bob 
Kennedy, Bob 


Eliska 
Eliska 
Eliska 
Eliska 
Eliska 
Eliska 
Eliska 


McGuire, Sidney 
McGuire, Sidney 
McGuire, Sidney 
McGuire, Sidney 


Jones, Walter 
Jones, Walter 
Jones, Walter 
Jones, Walter 
Jones, Walter 
Jones, Walter 
Warren, Wayne 
Warren, Wayne 
Warren, Wayne 
Nash, Gail 

Nash, Gail 


Nash, Gail 

Williams, Steve 
Williams, Steve 
Williams, Steve 
Williams, Steve 


Stephanie 


MGR ID 
BNF 
BNF 
BNF 
BNF 
BNF 
GAP 
GAP 
GAP 
GAP 
GAP 
GAP 
GAP 
GAP 
GAP 
GAP 
GAP 
BPS 
BPS 
BPS 
BPS 


124660. 
274375. 
49980. 
103874. 
143375. 
32925. 
54875. 
25002. 
66341. 
50871. 
24990. 
46091. 
47309. 
37408. 
47370. 
25231. 
82315. 
62340. 
46740. 
28570. 
49584. 
31580. 
25915, 
53634. 
77247 
81375. 
104019. 
54875. 
62340. 
38750. 
39675. 
35582 
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AMOUNT 
000000 
000000 
000000 
800000 
000000 
000000 
000000 
780000 
500000 
200000 
000000 
440000 
940000 
520000 
000000 
980000 
000000 
000000 
000000 
000000 
650000 
000000 
860000 
120000 


.500000 


000000 
500000 
000000 
000000 
000000 
950000 


.500000 


Since both queries reference different occurrences of the same table, correlation names (for 
example, sp1 and sp2) must be supplied for each separate salesperson table to 
distinguish between the inner and outer salesperson tables. 


Subqueries that can be used to simply check whether a select statement returns any row 
are specified as follows: 


select ... from ... where [not] exists (select * from ... 


Subqueries of this type do not return any rows but simply return TRUE if the subquery 
returns at least one row or FALSE if no rows are found. For example, assuming that the 
sale_id column in the customer table was an undeclared foreign key to the salesperson 
table, the following update statement would use an exists subquery to ensure that the 
referenced salesperson did indeed exist. 


update customer set sale_id = "CML" 
where cust id = "SEA" 
and exists (select * from salesperson where sale id = "CML"); 


*** 0 rows affected 


Note from this example that subqueries can even be specified in update and delete 
statements. 
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Chapter 7 
Entering and Modifying Data 


7.1 introduction 


The previous chapters have shown you how to retrieve data from an RDS SQL database. 
This chapter will show you how to enter data into your database and how to modify and 
delete data that already exists in your database. In particular, this chapter discusses: 


e grouping related database modification statements into transactions 
e inserting rows into tables 

e updating columns in a table 

e deleting rows from a table 


7.2 Transactions 


Transactions are used to maintain the logical consistency of a database by allowing 
multiple, related database modification statements to be grouped together and 
committed to the database as a single unit. Transactions guarantee that either all of the 
associated changes are stored in the database or that none of them are stored (for 
example, if the database server were to go down due to a power failure, uncommitted 
changes would not have been stored). 


A transaction is started either explicitly by executing a begin transaction statement, or 
implicitly by executing an insert, update, or delete statement. The changes affected by 
all insert, update, and delete statements after a transaction begins are made permanent 
by executing a commit statement. Alternatively, you can undo (that is, discard) the 
changes by executing a rollback statement. However, once the changes have been 
committed, they cannot be rolled back. 


RDS SQL also provides the ability to mark save points within a transaction, enabling 
partial rollbacks. 


You must use transactions in RDS SQL. If you do not commit your changes to the 
database before you end your session, all of the changes you have made will be lost. 


Descriptions for each of the transaction processing statements are given below. 
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begin [work | trans | transaction] [trans id] 


Begins a transaction. If not specified, the transaction begins when the first database 
modification statement is executed. The transaction id (trans_id) is an optional identifier 
of your choosing. Note that you cannot begin a transaction when there is already an 
active transaction. 


{mark | save} [work | trans| transaction] trans_id 


Marks a transaction save point. You can only execute this statement when a transaction 
is active. The transaction identifier must be specified. It is to be used with a 
corresponding rollback statement. 


commit [work | trans! transaction] [trans id] 


Commits the changes made during the transaction to the database and end the 
transaction. If a transaction identifier is specified, it must match the one specified in the 
begin statement. 


rollback [work | trans! transaction] [trans id] 


Rolls back (discards) all changes made during the transaction. If a transaction id is 
specified and it corresponds to one specified on a previous mark only, the changes made 
since the mark statement are discarded. Other changes made during the transaction 
remain in effect. If the transaction id is not specified or if it corresponds to one specified 
in the corresponding begin statement, all changes are rolled back, terminating the 
transaction. 


Example transactions are given in the following sections. 


7.3 Inserting Rows into a Table 


7.3.1 Insert Values 


You insert rows into a table using the insert statement. The syntax for the insert 
statement is given below. 


insert into table_name[(column_name[, column name]...)] values(constant[, constant|...) 


The values to be inserted are explicitly specified using the values clause. 


If a column name list is specified, then it must name columns defined in table name. The 
values must be specified in the same order. If no columns are specified, the values must 
be listed in the same order as the columns defined in the create table for table name. 
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An insert must contain a non-null value for each column that is defined to contain only 
non-null data. 


For example, the following statement inserts a new salesperson into the salesperson 
table. 


insert into salesperson(sale_id, sale_name, dob, commission, region, 
office, mgr_id) 
values ( "MMB" , "Bryant, Mike",date "1960-11-14",0.05,0, "SEA", "BNF"); 


commit; 


Each column of the salesperson table is specified in the column list (they can be specified 
in any order). The values for each column are specified in the values list and must be 
specified in the same order as their associated columns. 


In the salesperson table, the mgr id column is a foreign key to the row of the salesperson 
table that contains the manager. If there was no salesperson with a sale id equal to 
"BNF", the insert would be rejected with a referential integrity violation. 


You do not have to specify all of the table's columns. Only those columns that have been 
declared as not null and do not have a default value need to be specified. The 
unspecified columns will be assigned their default value, or null if there is no default 
value. 


If you do not include a column list, then you must specify the values in the order in 
which the columns have been declared in the create table (or create view) and values 
must be provided for all of the table's columns. Primary key columns of type rowid, 
however, are automatically generated and, thus, must not be assigned a value. 


The next example shows the insert statements needed to store a complete sales order in 
the database. 
begin work "enter order"; 


insert into sales_order 
values ("SEA",2328,date "1993-06-30",time "13:17:00",30036.50,2553.10); 


insert into item values (2311,16311,30); 
insert into item values (2311,18061,200); 
insert into item values (2311,18121,1000); 
commit work "enter order"; 


The columns in the sales order table are, respectively, cust id, ord num, ord date, 
ord time, amount, and tax. The columns in the item table are ord num, prod id, and 
quantity. Note that this is a single transaction, which contains four insert statements. 
Hence, there is a single commit statement. 


Time constants are entered similarly to date constants. Table 7-1 below shows the format 
options available for time values. 
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Table 7-1. Time Constant Formats 


1. time "HH:MM:SS" 
2. @"HH:MM{[:SS]" 


The three built-in constants described in table 7-2 below are available for use in SQL. 


Table 7-2. Built-In Constants 


NN 

statement containing the user reference. 

A date literal that returns the current date at the time the statement 
containing the today reference is executed. 


now A timestamp literal that returns the current timestamp at the time the 
statement containing the now reference is executed. 


The following examples illustrate the use of the built-in constants. 


å statement that could be executed from an extension module or stored 
procedure 

. that is always executed when an connection is made. 
insert into login log(user name, login time) 
values(user, now); 


check today's action items 
select cust id, note text from action items where tickle date 


Constraints that have been defined in the create table statement are checked when the 
insert is executed. If any are violated, the insert is rejected. 


7.3.2 Importing/Exporting Data 


A single insert statement can be used to import multiple rows into a table, where the 
values to be inserted are stored in a text file. This allows the insert statement to be used 
to perform a bulk load of a table. The syntax for this form of the insert statement is as 
follows: 


insert into table namel[(column namel, column name]...) 
[from] file "file name"[, "char"] [on devname] 


The specified file must reside in device devname. If no device is given, the file must reside 
in the user's device. The "char" can be used to specify the field delimiter character used in 
the file. By default, the field delimiter is a comma. 
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For example, the following lists the contents of file "outlet.asc": 


"SEA", "Seattle", 
"TAX". "Los Angeles", ICAT, 
"DAL", "Dallas", TEXY 5 
"BOS", "Boston", "MA" 
CHIT, "Chicago", VEI, 
"KCM", "Kansas City", "MO", 
"STL", "St... Louis"; "MO", 
"NYE, "New York City", "NY", 
TATE "Atlanta", "GA" 
"MIN", "Minneapolis", "MN", 
"DEN", "Denver", 00, 
"WDC", "Washington", 


KONUKNNNHKHKUOO 


All of these values can be loaded into the outlet table using the following statement: 


insert into outlet(loc id, city, state, region) file "outlet.asc"; 


commit; 


If any of the rows being inserted from the ascii file violate any of the integrity constraints 
defined on the table, the load will terminate with the error and all of the rows that have 
been inserted up to that point will be rolled back automatically. 


The fastest possible import processing can be achieved by first opening the database in 
exclusive access mode with transaction processing turned off, as shown below. 


open invnto exclusive with transaction off; 


This mode requires exclusive access to the database and results in the fastest possible 
processing because locking is not required and transaction logging is not performed. The 
price that is paid for this performance, however, is the loss of recoverability should the 
database server go down (for example, in a power failure) while the insert is being 
processed. Moreover, if any integrity constraints are violated, the insert will terminate 
but the rows that had been inserted cannot be rolled back. In fact, you will not be able to 
roll back in any event because there is no transaction log with which the system can 
perform the rollback. 


Data can be exported from an SQL database into an ASCII file using the following form 
of the insert statement. 


insert into file "file name"[, "char"] [on devname] [from] select_stmt 


This insert statement will output the results of the specified select statement to the 
specified file on devname or the user's device if devname is not given. The "char" defines 
the field value separator that will be used in the output file. 
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7.4 Updating Columns in a Table 


The update statement is used to modify the values of one or more columns of one or 
more rows in a table. 


update table_name 


set column_name = {expression | null} [, column_name = {expression | null}]... 
[where cond_expr] 


The values to which the named columns in the set clause are assigned are the evaluated 
results of the specified columns. The values of the columns in table_name that are 
referenced in the expressions are the pre-updated column values. The rows that are 
updated are those for which the conditional expression is true. If the update of any of 
the selected rows results in an integrity constraint violation, the update is aborted and 
the changes to the rows that had already been modified are discarded. If the where 
clause is not specified, all of the rows in table_name are updated. 


The following example shows a basic update statement that sets the commission for 
salesperson with sale_id "SWR" (Stephanie Robinson) to 8 percent. This update modifies 
only a single row of a table. 


begin transaction; 
update salesperson 


set commission 0.08 
where sale_id = "SWR"; 
commit transaction; 


The next example gives each non-manager salesperson a 10% increase in their 
commission rate. 


update salesperson 
set commission = commission + 0.10*commission 
where mgr_id is null; 

commit work; 


Rams Data Processing, Inc. has moved to a new address. The next statement modifies 
the relevant columns in the customer table. 


update customer 
set address = "17512 SW 123rd St.", city = "Tustin", zip = "90121" 


where cust_id = "LAN"; 
commit trans; 


Eliska Wyman has left the company. Until her replacement has been hired, her 
customers in New York and New Jersey are to be serviced by Greg Porter and her other 
customers by Sidney McGuire. The following statements make the appropriate changes. 
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begin trans "reassign ERW's customers"; 
update customer 

set sale id = "GAP" 

where sale id = "ERW" and state in ("NY", "NJ"); 
update customer 

set sale id = "SKM" 

where sale id = "ERW" and state not in ("NY", NJ"); 
commit trans "reassign ERW's customers"; 


The next example uses the if selection function to do ina single statement the same 
modifications made by the two update statements in the previous example. 


begin trans "reassign ERW's customers"; 

update customer 
set sale id = if (state in ("NY","NJ"), "GAP", "SKM"); 
where sale id = "ERW"; 

commit trans "reassign ERW's customers"; 


You are not allowed to update a primary key column for rows that are referenced by 
other foreign key columns. 


7.5 Deleting Rows from a Table 


After reassigning ERW's customers, it would be necessary to delete her from the 
salesperson table. The delete statement is used to delete rows from a table. The 
following statement shows how it is used to delete ERW. 


delete from salesperson where sale id = "ERW"; 


The syntax for the delete statement is shown below. 


delete from table name 


[where cond expr] 


The statement deletes all of the rows from table name for which the conditional 
expression in the where clause is true. If the where clause is not specified, all of the rows 
in table name are deleted. You can only delete rows that are not referenced by other 
foreign key columns. If any of the rows selected by the where clause have existing 
foreign key references, then the entire delete is rejected. Thus, in the previous example, 
if ERW happened to have some rows in the note table with a sale id equal to "ERW", the 
delete would have been rejected with an error indicating the presence of foreign key 
references. 


You are not allowed to delete rows that contain a primary key that is referenced by other 
foreign keys. You must first delete the referencing rows before you can delete the 
referenced row. 
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Chapter 8 


Using Views 
pees 


8.1. Introduction 


In Chapter 5, you were introduced to views through an example that showed how views 
can be used to simplify query specification by eliminating the need to formulate the join 
predicates when several tables need to be accessed. This particular use of views to 
simplify user access to the database is one of the important uses of views. This chapter 
will describe how to create and use views. 


A view is a virtual table that is defined to be the table that results from the select 
statement on which the view is based. The view defines a virtual table in that while you 
use it just like you use any table, it does not contain any rows of its own; instead, it is 
solely composed of rows from the underlying base tables. 


8.2. Creating a View Definition 


You can define a view almost as easily as you write a select statement. In fact, that is 
exactly how you define a view. The syntax for the create view statement is given below. 


create view [dbname.]viewname ["description"] [(colname |, colname]...)] 
as select expression[, expression]... from tablename[, tablename]... 
[where cond_expr] 
[group by colname [, colname]... [having cond_expr]] 
[with check option] 


The table defined by the view is the one that results from execution of the specified 
query. The select expressions are used to constrain the visible columns in the view. The 
where clauseof the select statement can be used to constrain the rows of the view to only 
those that satisfy the condition. 


If a list of column names is specified then there must be one column name (colname) for 
each select expression. The value associated with the first column is the value of the first 
select expression, the value for the second column is the result of the second select 
expression, and so on. If a column name list is not specified then the names of the 
columns of the view are the same as the names of the columns in the select statement. If 
any of the columns in the select statement are expressions or if two columns have the 
same name then a column name list must be specified. 
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Views are associated with the database from which they retrieve their information. If 
more than one database is accessed by the defining select statement, by default the view 
is associated with the database that contains the first table listed in the from clause. You 
can override this by qualifying the tablename with the dbname you want. However, it 
must still be one of the databases that is to be accessed by the view. 


Notice that the select statement that defines the view cannot have an order by clause. 


You cannot execute a create view inside an active transaction. Since this statement 
updates the system catalog it is itself a complete transaction. 


The following create view statement defines a view called sales_summary that contains 
three columns: name (sale_name), sales_month (month the order was taken), and 
order_tot (the total orders for the salesperson for the month). Use the view to provide a 
summary of the total order amounts per month per salesperson for the current year. 


sales_month, order_tot) as 


create view sales summary (sales month, 


select month(ord date), sale name, sum(amount) 
from salesperson, customer, sales order 
where year (ord date) = year(curdate()) and 


salesperson.sale id = customer.sale id and 
customer.cust id = sales order.cust id 
group by 1, 2; 
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8.3. Selecting Data from a View 


You use a view in exactly the same way that you would use any table. For example, the 
select statement shown below uses the view defined in the previous section. 


select * from sales_summary where sales_month in (1,2); 


SALES_MONTH NAME ORDER_TOT 


T Flores, Bob 19879.500000 
1 Jones, Walter 76887.870000 
1 Kennedy, Bob 328070.830000 
1 McGuire, Sidney 3437.500000 

J Nash, Gail 136250.000000 
1 Porter, Greg 74034.900000 
i Robinson, Stephanie 29073.510000 
yi Stouffer, Bill 15901.610000 
1 Warren, Wayne 79957.980000 
1 Williams, Steve 32094.750000 
1 Wyman, Eliska 173878.570000 
2 Flores, Bob 8824.560000 

2 Jones, Walter 86065.000000 
2 Kennedy, Bob 103874.800000 
2 McGuire, Sidney 9386.250000 

2 Nash, Gail 3927.900000 

2 Robinson, Stephanie 164816.470000 
2 Stouffer, Bill 4049.090000 

2 Warren, Wayne 11265.920000 
2 Williams, Steve 62340.000000 
2 Wyman, Eliska 74851.200000 


The next example includes an order by clause. Notice that although the order_tot value 
is calculated using an aggregate function (sum), the comparison is specified in the where 
clause and not in a having clause. Had the comparison been defined as part of the view 
then it would indeed need to be in the having clause of the create view's select 
statement. 


select order_tot, sales_month, name fr 
where order_tot > 10000.0 order by 


om sales_summary 
1 desc; 


ORDER_TOT SALES_MONTH NAME 
328070.830000 Kennedy, Bob 
252425.000000 Porter, Greg 
173878.570000 Wyman, Eliska 
164816.470000 Robinson, Stephanie 
143375.000000 Kennedy, Bob 
137157.050000 Wyman, Eliska 
136250.000000 Nash, Gail 
104019.500000 Nash, Gail 
103874.800000 Kennedy, Bob 
103076.790000 Wyman, Eliska 


ANDEFAWNHE WH 
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8.4. Dropping a View 


When a view is no longer needed you can delete the view from the system by issuing a 
drop view statement. 


drop view [dbname.]viewname [cascade | restrict] 


The cascade option (default) will cause all other views that reference this view to be 
automatically dropped by the system. The restrict option will prohibit dropping 
viewname if there are any other views that reference this view. 


For example, the sales_summary view shown below uses the acct_orders view. 


create view acct_orders as 
select sale_id, sale_name, cust_id, ord_num, ord_date, amount 
from salesperson, customer, sales_order 
where salesperson.sale_id = customer.sale_id 
and customer.cust_id = sales_order.cust_id; 


create view sales_summary(sales_month, sales_month, order_tot) as 
select month(ord_date), sale_name, sum(amount) 
from acct_orders where year(ord_date) = year (curdate() ) 
group by 1, 2; 


The following statement will be rejected by SQL because there exists a dependent view 
(that is, sales_summary). 


drop view acct_orders restrict; 


The next statement, however, will drop not only the acct_orders view but sales_summary 
as well. 


drop view acct_orders cascade; 


The same result will occur using the next statement because cascade is the default action. 


drop view acct_orders; 


Thus, when in doubt, always specify restrict. You cannot undo (or roll back) a drop 
view. 


8.5. Updateable Views 


A view is considered updateable (that is, it can be the table referenced in an insert, delete 
or update statement) when the select statement that defines the view: 

e Does not contain a distinct, group by or order by clause, or a subquery, 

e Does not contain any column expressions, and 


e Hasa from clause that refers to only a single table—and if that table is itself a 
view, then it must be updateable. 
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A view that has a with check option specification must be updateable. When specified, 
the with check option requires that any insert or update statements that reference the 
view satisfy the where condition of the view's defining select statement. 


The following create view defines a view that restricts the outlet table to only those rows 
that are located in western region states. 


create view west_outlets as 
select * from outlet where state in ("CA","CO", "OR", "WA") 


with check option; 


If you were to attempt to insert a row into the west_outlets view that had a state value 
other than one of the states listed in the where clause, the insert statement would be 
rejected as in the example below. 


insert into west_outlets values 
*** integrity check violation: 


("SAL", "Salem", "MA" y 
check 


0); 


If the with check option had been omitted in the view definition, the row would have 
been stored. 


8.6. Views and Database Security 


One of the more important uses of views is in conjunction with database security. Views 
can have permissions assigned to them just as with any table. Ifitis important to be able 
to restrict which columns from a base table users can have access to, you can simply 
define a view that includes only those columns. The view would be accessible to those 
users, whereas the base table would not. For example, the following view could be used 
to hide personal information about salespersons such as date of birth and commission 
rate from unauthorized eyes. 


create view sales staff 
as select sale id, sale name, region, office, mgr id from salesperson; 


Once the proper permissions have been established, the dob and commission columns 
would not be accessible to normal users. 


You can also use views to restrict rows from certain users. The west outlets view in the 
last section could be set up so that those salespersons from the western region could only 
access information (for example, inventory quantities) from offices located in those 
particular states. 
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Chapter 9 
Database Security 


9.1 Introduction 


Database security provides the ability to restrict user access to database information 
through restrictions on the database columns and tables, or on the kinds of statements 
that a particular user can use. 


The RDS system has two classes of users. Administrator users have full access rights to 
all system capabilities and databases. Normal users have only the access rights granted 
to them by administrators and database owners. A system will typically have only a 
single administrator user (often referred to as the system or database administrator). 
RDS does not, however, require that there be only one administrator. 


RDS SQL provides two classes of access privileges: command privileges and database 
access privileges. Command privileges allow an administrator to specify the kinds of 
commands that a particular user is allowed to use. Database access privileges allow an 
administrator or database owner to specify the database information and operations that 
a particular user is allowed to access. 


9.2 RDS Users 


Before a user can access RDS SQL, the user must be entered as a valid RDS user. 
Administrators can define RDS users through the RDS administration utility program. 
Refer to the RDS Administrator's Guide for details. When a valid RDS user connects to 
RDS SQL for the first time, RDS SQL assigns default system access privileges to that user 
unless the user has RDS administrator rights. Administrators have full access rights to 
all SQL commands and databases. 


For non-administrators, basic access rights include only the ability to select from 
databases that have public access permission. Specific command or database access 
privileges for particular user are assigned using the grant statement. Privileges can be 
rescinded using the revoke statement. Newly granted (or revoked) access privileges do 
not take effect until the specified user(s) log in. If they are already logged in at the time 
the grant/revoke commands are issued, they must log out (that is, disconnect) and log in 
again for the new privileges to be applied. 
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9.3 SQL Command Access Rights 


Command privileges can be granted using the following form of the grant statement. 


grant_command_privileges: 
grant command_spec to {public | user_id [, user_id]...} 


command_spec: 
all commands 
| all commands but command[, command]... 
| commands command[, command]... 


command: 
create database 
create view | create procedure 
insert | update | delete 
lock table 


The specific command privilege classes that can be granted are given in the table below. 
All other commands can be issued by any user. 


Table 9-1. Command Privileges 


insert, update, or delete 


The user id can be specified as an identifier or a string. Only use the identifier form if the 
user name that was entered through RDS was all upper-case (SQL converts all input text 
to upper-case except strings). 


The example below grants permission for everyone to issue any commands except DDL 
commands, allowing only George and Martha to create datatabases. 


grant all commands but create database to public; 
grant all commands to "George", "Martha"; 


The next example restricts Jack to doing select, update and create view statements. 
grant commands create view, update to Jack; 


A user who attempts to execute a command for which she or he does not have 
permission will get back an access rights violation error (errACCESS). . 
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9.4 Granting Access Rights on Database Tables 


You can assign user access privileges to database tables, views, and columns using the 
following form of the grant statement. 


grant_item_privileges 
grant {privilege [, privilege]... | all [privileges]} 
on [dbname.]table_name to (public! user id [, user_id]...} 


privilege 


select | delete | insert 
| update [(column name |, column_name]...)] 


The creator of a database (that is, the user who issued the create database statement) is 
the owner of that database. When a database is created, only the owner (and, of course, 
administrator users) is allowed to access that database. The owner can grant other users 
certain access privileges to the database. The grant statement is used to assign these 
access privileges to other users. Particular privileges can be granted to specific users or 
to all users (public). The types of access privileges are listed in the following table. 


update Allows user to update the specified columns in the specified table or 
view. 

all privileges Allows user all of the above access privileges on the specified table(s) 
or view(s). 


In the example below, all users are given select privileges on the inventory tables while 
George and Martha are the only users allowed to modify the inventory database. 


select on invntory.product to public; 
grant select on invntory.outlet to public; 
grant select on invntory.on hand to public; 
grant all on invntory.product to "George", "Martha"; 
grant all on invntory.outlet to "George", "Martha"; 

grant all privileges on invntory.on_hand to "George", 


"Martha"; 
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Access to the columns and/or rows of a table can be restricted for certain users through 
use of views and by only granting those users permission to use those views (rather than 
granting access to the base tables themselves). The following example illustrates how a 
view can be used to restrict access to a portion of a table. 


create view skk_customers as 
select * from customer where sale_id = "SKK" 


with check option; 


grant all privileges on skk customers to sidney; 


9.5 Revoking Access Rights 


To rescind command privileges, an administrator can issue a revoke which identifies the 
specific commands that a user can no longer issue. As with grant, two forms of 
specification are allowed as shown below. One form identifies the commands from the 
restricted list that the user cannot use. The other form (all but) identifies the commands 
from the restricted list that the user can use. 


revoke_item_privileges 
revoke {privilege [, privilege]... | all [privileges]} 
on [dbname.]table_name from {public | user_id [, user_id]...} 
privilege 
select | delete | insert 
| update [(column name [, column name]...)] 


revoke command. privileges 
revoke command spec from (public | user id [, user id]...) 


command spec 
all commands 
all commands but command[, command]... 
commands command[, command]... 


create database 

create view | create procedure 
insert | update | delete 

lock table 
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The specified privileges that are being revoked must have been previously granted. The 
specified privileges can be revoked from all users (public) or be restricted from only the 
users specified in the revoke command. 


For example, the following statements remove George's modification privilege on the 
inventory database. 


revoke insert, update, delete on product from "George"; 
revoke insert, update, delete on outlet from "George"; 
revoke insert, update, delete on on hand from "George"; 


When the create database command privilege is revoked, the user is restricted from use 
of any of the DDL commands. 


When a user's select privilege on a table or view is revoked, all views which that user has 
defined on that table or view are automatically dropped. 


The example below shows an RSQL utility script illustrating how the home sales view is 
automatically dropped when Martha's access privilege on salesperson is revoked. Also 
note that Martha has to disconnect and reconnect in order for the changed permissions to 
take effect. 


.C I RDS Admin xyzzy 
grant select on salesperson to "Martha"; 
.C 2 RDS Martha HipposAreHip 

create view home sales as select sale name from salesperson where office 
= "SEA"; 

select * from home sales; SALE NAME 

Flores, Bob 

Porter, Greg 

Stouffer, Bill 

Chris 


revoke select on salesperson from "Martha"; 
.C 2 RDS Martha HipposAreHip 
select * from home_sales; 

**** RSOL Error 14002: table not found: HOME SALES 
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Chapter 10 
Stored Procedures and 


User-Defined Functions 
eS ee eee Se 


10.1 Introduction 


A stored procedure is a pre-compiled group of one or more SQL statements that are stored 
in the RDS SQL system catalog. You can use stored procedures to pre-define a wide 
variety of commonly used SQL statements. 


A user-defined function is an application-specific function that you use just like the RDS 
SQL built-in scalar and aggregate functions, except that it is specifically developed to 
meet the needs of your particular application. RDS SQL user-defined functions are: 1) 
coded in C, 2) reside in a DLL (dynamic link library), shared library, or Netware 
Loadable Module (NLM) on the database server, and 3) are called by the RDS SQL 
system when referenced in an SQL statement. 


This chapter will describe: 


e How to create a stored procedure 

e How to execute stored procedures 

e How to use user-defined functions 

e How to use user-defined functions as triggers 


Refer to the RDS SQL C Programmer's Guide for the information you need to write your 
own user-defined functions. 
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10.2 Creating a Stored Procedure 


To create a stored procedure, use the create procedure statement as defined by the 
following syntax. 


create {proc | procedure) proc_name [(arg_spec [, arg_spec]...)] 
SQL statement [;] [SQL statement [;]]... 
end (proc | procedure) ; 


arg spec: 
arg name type spec [default constant] 


type spec: 
integer | smallint | real | float | decimal | (char | character) | date | time | timestamp 


The stored procedure consists of all statements specified up to the end procedure. The 
name of the procedure is proc name and it must not duplicate any other procedure name 
stored on the server. A stored procedure is owned by the user who each created it. You 
can define stored procedures with arguments. The type spec specifies the type of each 
argument and is used to validate type compatibility whenever the procedure is called. 
Default values for the arguments can be specified. The length of arguments of type char 
and the precision and scale of arguments of type decimal is determined from the context 
in which the arguments are used. The arguments are referenced in the procedure's SQL 
statements by name. 


Stored procedures can contain calls to other stored procedures. Å stored procedure can 
contain any SQL DML statement except create procedure, create temporary table, and 
create view. 


The SQL statements contained in the create procedure statement can but do not need to 
be separated by semi-colons. If you are using the RSQL interactive utility and you are 
using semi-colons to separate the SQL statements, make sure that you do not end a line 
with a semi-colon because the utility will interpret that as the end of the statement, 
prematurely sending the create procedure to the server before you've entered the end 
procedure clause. 


The order report procedure below is a typical example of how you might use a stored 
procedure. The arguments supply the date range over which a standard report is 
produced. If the end date is not supplied when the procedure is executed, the end date 
will be set to the current date. 
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create procedure order_report 
today) as 
select sale_name, company, ord_num, ord_date, amount, tax 
from salesperson, customer, sales_order 
where salesperson.sale_id = customer.sale_id and 
customer.cust_id = sales_order.cust_id and 
ord_date between start_date and end_date 


(Start date date, end date date default 


end procedure; 


Assuming that the salesperson's sale id is the same as his or her user name, the 
following procedure will return all of a salesperson's notes in date order for each 
customer for the specified note_id. Note that you can abbreviate procedure as proc. 


create proc check_tickle(id char) as 

select note_date, cust_id, textln 

from note, note_line 

where note_id = id and sale_id = user() and 

note.note_id = note_line.note_id and note.note_date = 

note_line.note_date 

order by 1, 2; 
end proc; 


The stored procedures from previous examples contained only a single statement. 

Stored procedures can contain any number of statements. The example below defines a 
stored procedure that uses two select statements to show the total amount of a particular 
product that is stored at all outlets followed by the total of that same product that has 
been ordered. 


create proc product summary (pid smallint) as 
select prod_id, prod_desc, sum(quantity) total_available from product, 
on_hand 


where prod_id = pid and product .prod_id = on_hand.prod_id 
select prod_id sum(quantity) total_ordered from item where prod_id = 


pid 
end proc; 


10.3 Executing a Stored Procedure 


The execute statement is used to execute a stored procedure. The syntax for this 
statement is as follows: 


execute | exec | run] proc name [(arg |, arg]...)] 
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If the stored procedure was defined with arguments then there must be one arg for each 
of the defined arguments and they must be passed to the procedure in the order in which 
they were defined in the create procedure statement. You do not have to supply a value 
for an argument that has a default value. If there are subsequent arguments that you do 
need to supply values for, you can skip an argument with a comma as shown below. 


execute myproc(17002,,1); 

The argument values that are specified must be literal constants of the correct type as 
specified in the procedure definition. 

The statement below invokes the order_report procedure. 

execute order report (date "06-01-1993", date "06-30-1993"); 

Given that the next statement is executed on 6/30/93, it will produce the same results as 
the one above because of the default value specified for end_date. 

exec order_report(date "06-01-1993"); 

The next example executes a procedure called check_tickle to return the notes concerning 


current sales prospects. As you can see from this example, you can say run as a 
synonym for execute. 


run check_tickle("PROSPECT") ; 


When an error occurs in the execution of any of the statements in a stored procedure, the 
error is immediately returned to the calling program and the execution of the procedure 
is terminated. 


A stored procedure that contains more that one select statement (as in the 
product_summary example given in the previous section) requires the application 
program to call function SQLMoreResults immediately after SQLFetch returns 
SQL_NO_DATA_FOUND. This is needed to determine if there are any more result sets 
and, if so, to initialize their processing. Refer to section 4.6, "Processing Stored Procedure 
Results," in the RDS SQL C Programmer's Guide for more information. 


10.4 User-Defined Functions 


User-defined functions (UDFs) provide a powerful mechanism by which the 
functionality of RDS SQL can be extended. User-defined functions are written in C and 
are installed in a DLL (dynamic link library), shared library, or Netware Loadable 
Module (NLM) on the database server. 
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User-defined functions have a variety of uses, such as: 


e Translating coded values into easy-to-read strings 
e Performing special-purpose computations 

e Adding new aggregate functions 

* Doing fast low-level database lookups 

e Implementing triggers 


You can learn how to write user-defined functions in the RDS SQL C Programmer's Guide. 
In this section, you will see how user-defined functions can be used. Once a UDE has 
been developed you need to inform RDS SQL about the kind of UDF it is and where to 
locate it. This is done through use of the create function statement shown below. 


create [scalar | aggregate] function fen name ["description"] [, fen name ["description") ]... 


[[scalar | aggregate] function fen name ["description"] [, fen name ["description"]....]... 
in libname on devname ; 


This statement registers in the RDS SQL system catalog one or more UDFs contained in a 
dynamic library called libname.dll (on OS/2 or NT; libname.nim on Netware) that is stored 
on the RDS device devname. The name of each function must be a unique identifier of not 
more than 32 characters. An optional description may be specified with each function 
name. Å UDF must be registered in this manner before it is used. 


For example, the following statements create three user-defined aggregate functions that 
are contained in a dynamic library called statpack on an RDS device named add ins. 


create aggregate function 
devsq "compute sum of the squares of deviations", 
stddev "compute standard deviation", 
geomean "compute the geometric mean" 

in statpack on add ins; 


You call user-defined functions from SQL statements in the same way that you call the 
RDS SQL built-in functions. The select statement below calls the standard SQL 
aggregate function avg as well as the user-defined aggregate function geomean. 


select state, avg (amount), geomean (amount) from customer, sales order 
where customer.cust id = sales order.cust id 


group by state; 
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The following select statement calls a function called tax_rate that returns the tax rate for 
a given city. 


select company, city, state, tax_rate(city, state) tax_rate from 
customer; 


The tax_rate function would, presumably, look up a locale's tax rate from some internal 
table or, perhaps, a table in the database. This function could be used, as shown in the 
next example, to display the sales orders that have tax amounts that do not correspond to 
the going rate. 


ord_date, amount, tax 


select company, city, state, ord_num, 
from customer, sales_order 
where customer.cust_id = sales_order.cust_id and 
not equal float (convert (tax, float), amount * tax_rate(city, 


state), 0.005); 


This example also uses an additional user-defined function called equal_float that returns 
true if the two floating point values differ by less that the value of the third argument. 
Note also the use of function convert (an RDS SQL built-in) to convert the value of the 
real column tax to type float. 


The SQL sub-directory in the RDS examples directory on the server computer contains a 
sample UDF module named udf.c. Defined in this module are six sample user-defined 
functions: std, stds, udfcount, subquery, HaveProduct, and OkayToShip. Two different 
standard deviation functions, std and stds, are provided: the second computes the 
sampled standard deviation, while the first computes the exact standard deviation. 
Another function, udfcount, performs exactly the same operation as the built-in count 
function. All three of these functions are aggregate functions. The other sample UDF is 
called subquery. This function takes a string containing a select statement that returns a 
single valued result. Functions HaveProduct and OkayToShip are trigger UDFs and are 
described in the next section. 


These functions can be compiled using the provided udf.mak makefile. The result DLL 
(or NLM) is called udf.dll (udf.nIm). After the DLL has been created, connect to RDS SQL 
and enter the following create function statement: 


create aggregate function 
std "actual standard deviation", 
stds "sampled standard deviation", 


udfcount "alternate count function" 
scalar function 

subquery "selectable subquery function" 
in udf on rdsall; 


The following examples illustrate the use of these functions using the example sales and 
inventory databases. 


You can show the average sales amounts and their standard deviations per salesperson 
using the following query. 
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select sale_name, avg (amount), std(amount) from salesperson, customer, 
sales_order 


where salesperson.sale_id = customer.sale_id and customer.cust_id = 


sales_order.cust_id 
group by sale name; 


The count and udfcount functions should return identical results from the following two 
queries. 


select sale name, count (cust id), udfcount (cust id) from salesperson, 
customer 
where salesperson.sale id = customer.sale id 
group by sale name; 


select sale name, count (distinct state), udfcount (distinct state) from 
salesperson, customer 


where salesperson.sale_id = customer.sale_id 
group by sale name; 


The next example shows the power of the subquery function in its ability to return 
percentage of total values in a single select statement. 


select state, 100*sum (amount) /subquery ("select sum(amount) from 
sales order") pct of sales 

from customer, sales order where customer.cust id = 
sales order.cust id 


group by state; 


The implementation of these UDFs is described in detail in Chapter, 5 "Server-based SQL 
Programming," in the RDS SQL C Programmer's Guide. 


10.5 Triggers 


A trigger is an action that is automatically performed in response to a specific event. In 
RDS SQL, triggers are implemented through user-defined functions that are called as a 
result of the execution of an insert, update, or delete statement. 


The create table statement (see section 11.3) allows the table or columns to be declared 
with a check clause that must always be true for all rows in the database. The check 
clause is a conditional expression that is typically used for such things as validating that 
a numeric column's value is within a certain range. 


A trigger in RDS SQL is a UDF that is called from within a check clause on a table. The 
function returns a value (1 for true and 0 for false) that is checked in the check condition. 
If the result of the condition is true, SQL allows the modification to complete. If the 
result is false, the modification is rejected. 


The sales and inventory example databases contain two triggers. The create table 
statements containing them is given below. The prod id and loc_id columns in the item 
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table reference the corresponding primary keys in the product and outlet tables in the 
inventory database. 


create table item 
( 
ord_num smallint not null references sales_order, 
prod_id smallint not null refernces invntory.product, 
loc_id char(3) not null references invntory.outlet, 
quantity int not null 
"number of units of product ordered", 
check( HaveProduct (ord num, prod id, loc id, quantity) = 
) in salesdl; 


create table ship log 
( 
ord date timestamp default now 
"date/time when order was entered", 
ord num smallint not null 
"order number", 
prod id smallint not null 
"product id number", 
loc id char(3) not null 
"outlet location id", 
quantity int not null 
"quanitity of item to be shipped from loc id", 
backordered smallint default 0 
"set to 1 when item is backordered", 
check( OkayToShip(ord_num, prod id, loc id, quantity, backordered) = 1 ) 
) in salesd0; 
The HaveProduct function automatically manages the inventory database and the 
ship log table. On insert, HaveProduct will look up the on hand record for the specified 
prod id and loc id. If there are enough items available, the ordered amount of the item is 
subtracted from the quantity in the on hand record and a row is inserted into the 
ship. log table from which a picking list will be created. If there are not enough items 
available, the quantity that is available is assigned to the order (that is, quantity is set to 
zero) and a row is inserted into ship_log for that amount. The remaining amount needed 
to fill the order is specified through an additional row in ship_log with the backordered 
flag set to one. On delete, HaveProduct will add the number of items ordered back into 
the on_hand record and set ship_log.quantity to zero for the appropriate rows. Update 


statements are not allowed on the item table. 


Rows in ship_log are deleted when an order is actually shipped. The OkayToShip trigger 
checks the backordered flag and, if set, rechecks the inventory to see if there are now 
enough items from which to fill the order. If there are still not enough, the delete is 
rejected. If there are, the inventory is updated and the required number of items are 
processed. 


Refer to Chapter 5, "Server-based SQL Programming," in the RDS SQL C Programmer's 
Guide for complete details about how to write your own trigger UDFs in C. 
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Chapter 11 
Database Definition 


11.1 Introduction 


A database definition is a detailed description of the data to be stored in a database and 
the relationships that exist among that data. In RDS SQL, a database definition consists 
of a set of tables, indexes, and join specifications. Each table consists of one or more 
columns and integrity constraints. 


You create the specification of a database definition using the RDS SQL Database 
Definition Language (DDL). The DDL specification is contained in a text file that you 
create using a text editor. You process the DDL specification using the RDS SQL DDL 
processor (Sddlp). This program reports any errors and, if there are none, will install the 
database on the database server. 


One of the key features of RDS SQL is the ability to have foreign and primary key 
relationships maintained through direct access methods. These pre-defined joins result in 
outstanding join processing performance. 


Table 11-1 gives a summary of the RDS SQL statements. 


Table 11-1. RDS SQL DDL Statements 


create database Creates a database definition. The subsequent DDL statements 
define the content of the database. 


create file Creates a file that will contain the rows of one or more tables or the 
key values from one or more indexes. The tables or indexes that are 
stored in the file are specified in the respective create table or create 
index statements. 


create table Creates a table and defines its columns and constraints. 
create index Creates an index on one or more columns in a table. 
create join Creates a pre-defined join between two tables from a foreign key. 


=; 
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This chapter will show you how to: 


e Create a database 

e Create a table and define columns 

e Specify integrity constraints 

e Create indexes and joins 

e Compile your DDL and install a new database on the RDS server 
e Create temporary tables and indexes 


e Declare columns containing C language structures and/or arrays 


11.2 Databases and Files 


11.2.1 Create Database 


The create database statement must be the first statement of your SQL DDL specification. 
The DDL statements that follow the create database statement define the contents and 
organization of the database. The syntax for the create database statement is as follows: 


create {database | schema authorization} dbname 
[{on | stogroup} device_name] 
[{enable | disable} null values] 
[{enable | disable} references count] 


The example below shows the use of create database in its simplest form. 
This could also have been specified in the ANSI standard form as follows: 


create schema authorization sales; 


By default, the files that comprise the database are stored on the RDS server on the 
standard device of the user that is submitting the DDL specification. You can explicitly 
indicate the device on which you want the database stored using the on clause. The 
device name that is specified in the on clause must exist on the RDS server. Consult the 
RDS Database Administrator's Guide for information about devices and how to create 
them. The example below specifies that the sales database files are to be stored on device 
mis. 


create database sales on mis; 
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For compatibility with DB2, stogroup is allowed as a synonym for on. See below. 


create database sales stogroup mis; 


The null values clause can be used to enable (default) or disable use of null values. RDS 
SQL manages null column values through a hidden null value indicator column 
contained in each table. If an RDS SQL application does not need to use null column 
values then this feature can be disabled. Note that this can also be controlled through an 
sddlp command line option (see section 11.5). The presence of this clause supersedes the 
sddlp option. 


Full referential integrity checking requires that every row that is referenced by any 
foreign key in the database exist. To enforce this integrity condition in the processing of 
a delete statement, RDS SQL maintains a hidden reference count column in each table 
that is referenced by a foreign key. Deletions of referenced rows are only allowed when 
this count is zero. Of course, extra overhead is incurred in order to maintain these 
reference counts. The references count clause allows you to disable the creation and use 
of reference counts when they are not being used for a particular application. When 
disabled, it will not be possible to delete rows from tables that are referenced by foreign 
keys on which a create join has not been defined. Note that this feature can also be 
controlled through an sddlp command line option. The presence of this clause 
supersedes the sddlp option. 


The create database statement below shows the use of these clauses for the RDS SQL 
system catalog. 


create database syscat 
on catdev 


disable null values 
disable references count; 


11.2.2 Create File 


The create file statement is used to define database files that can contain the rows of one 
or more tables or the keys from one or more indexes. By default, the contents of each 
table and index are stored in separate files having system-generated file names. You can 
use the create file statement to override the default and place tables and indexes 
wherever you want. In general, it is usually best to use as few files as is practical. At 
present, RDS has a limit of 256 files per database. By using fewer files, you reduce the 
amount of file opening and closing that the server needs to do, improving performance. 
To minimize storage waste, it is recommended that you place only similarly sized items 
in the same file. 
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The syntax for the create file statement is as follows: 


create file file name [pagesize bytes] [on device name] 


The file name is an identifier of not more than 32 characters. By default, the file is stored 
on the database's device. You can override this default with the on clause, where 
device name must be a valid RDS device. 


The pagesize clause specifies the size in bytes of each page of the file. A database file 
consists of contiguous fixed-length pages. A page is the smallest unit of I/O performed 
by the RDS system. Page sizes should typically be equal to a multiple of the basic block 
size for the server computer's host operating system (usually a power of 2 times 512 
bytes). The default page size for each file is 1024 bytes. Larger page sizes allow more 
rows or keys at a time to be read into the database cache. However, that does not always 
equate to better performance. The optimal use of the RDS cache depends on the nuances 
of a particular application usage. 


The tables or indexes that are to be stored in a given file are determined from the in 
clause of the create table and create index statements. 


For compatibility with DB2, you can use tablespace for file. 


The create file statements from the sales database specification are shown below. 


7* sales database file declarations 

åt 

create file salesd0; // salesperson, customer, sales order 

create file salesdl; // item 

create file salesd2; // note 

create file salesd3; // note line 

create file salek0 // sale key, cust key, order key, cust order key 
pagesize 2048; 

create file salekl // order nåx, note key 

pagesize 2048; 


Notice that a DDL specification can include comments. The sddlp utility allows 
comments to be specified in three ways. Any text between /* and */ is ignored, as is text 
from // or -- to the end of the line. 
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11.3 Table Definition 


You define a database table using the create table statement The syntax for the create 
table statement is given below. 


create table base table name ["description"] 
(column defn [, column defn]... [, table constraint]...) [in file name] 


column defn 
column name type spec [default (constant | null | user}] 
[not null] [unique | primary key 
| references table_name[(column_name)]] 
[check (cond_expr)] ["description"] 


table constraint 
[{unique | primary key} ( column name [, column name]... )] 
l [foreign key ( column name [, column_name]... ) 
references table_name|[( column name, column_name]...)] 
| check ( cond_expr ) 


table name 
: [dbname.]base table name 


(varchar | char) (length) 
| {double [precision] | float} 
l real 

| {integer | int | long} 

| {smallint | short} 

| decimal (precision[, scale]) 

| date 
| 

| 

| 

| 


time [(precision)] 
timestamp [(precision)] 
rowid 


c data[ [dim1'] [‘['dim2’]] ['['dim3’]']] c type spec 


: c_base_type 
| struct '|' 


base type field_name['['dim1’]' ['['dim2 TI [T'dim3']]] ; 
[base type field name['['dim1 T [['dim2']] ['['dim3’]]] ;]... 


igned] (char | short | int | long} | float | double 
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The name of the table, base_table_name, is an identifier that must be unique from all other 
tables in the database. You can provide the table and its columns with an associated 
description string. 


char 


varchar 


float 


real 


integer 


smallint 


decimal 


date 


time 


timestamp 


rowid 


c_data 


Table 11-2. RDS SQL Data Types 


A fixed-length character string of the specified length. Stored as a null- 
terminated string of length+1 bytes. 


A variable-length character string of the specified maximum length. 
Stored as a null-terminated string. In this release, this is the same as a 
char. 


A double precision floating point number (usually 8 bytes long). Same as 
double or double precision. 


A single precision floating point number (usually 4 bytes long). 


A 4-byte signed integer number between -2,147,483,648 and 
+2,147,438,647. Same as int, long and longint. 


A 2-byte signed integer number between -32,768 and +32,767. Same as 
short. 


A binary-coded decimal number of the specified precision and scale. If 
precision is not specified it defaults to 15. If scale is not specified, it 
defaults to 0. 


A long containing the number of elapsed days since Dec 31, 1 BC (that is, 
Jan 1,1 AD is 1). 


A long containing a four decimal place, fixed point time of the form 
HHMMSS.dddd. 


Contains both a date and time value. 


A row identifier number. Rowids are assigned . by the system and consist 
of a monotonic long integer value that is equal to the record number in the 
database file that contains a particular row of a table. Rowids are 
available for use with primary and foreign keys to provide direct access 
capabilities and reduce the need for indexes. 


A column containing C language data constructs comprised of basic data, 
struct data, and/or multi-dimensioned arrays (see section 6.1 in the SQL C 
Programmer's Guide). 


—==================>>>>>>>====>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>=>= 
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Each column of the base table is defined by an identifier, column_name, and a data type. 
The column name must be distinct from the other columns in this table but you can use 
the same name in other tables if you so choose. You must indicate the kind of data that 
the column is to contain by specifying a data type as described in table 11-2.. 


You can define a column to contain only non-null data, unique values or as the table's 
primary key. You can also specify a default value to be automatically stored when 
processing an insert statement that does not specify a value for the column. The default 
value can be a literal constant of the proper data type or null (which is the default 
default). The references clause identifies the column as a foreign key of the specified 
table. You can use the check clause to define a condition that must be true for every 
value of the column in the database. This condition can include constants and call built- 
in or user-defined functions, but can only refer to the single column. The check 
condition cannot have a subquery. 


The unique table constraint specifies that the column (or columns taken together) must 
contain a different value for each row in the table. The primary key clause identifies the 
column (or columns taken together) which must be unique and forms the primary key of 
the table. A unique or primary key can be composed of up to eight columns. Only 
tables with a unique or primary key constraint can be specified in a references clause of 
another create table statement. The in clause can be used to specify the name of the file 
in which the rows of the table are stored. If a file name is not specified, the rows will be 
stored in a separate file with a name derived from the database name. 


Shown below is the table definition for the product table from the inventory database. 


create table product 
( 


prod_id smallint primary key 
"product identification code", 
prod_desc char(39) not null 
"product description", 


price float 

"retail price", 
cost float 

"wholesale cost", 
check(price > cost) 


This table contains five columns. The prod id column is a small integer that is the table's 
primary key. Access to rows of the product table will often be based on this value. The 
prod desc column must (it is not null) contain up to a 39-character description. The 
price and cost columns are floating point values that store the retail price and wholesale 
cost of the product item. The table also contains a check clause that ensures that the 
price is always higher than the cost. 
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The next example gives the definition of the outlet table from the inventory database. 


create table outlet 


( 


loc_id char(3) primary key, 
city char(17) not null, 


state char(2) not null, 
region smallint not null check(region between 0 and 3) 
"regional U.S. sales area" 


Here the primary key is a three-character location identification code. The region column 
contains a check condition that ensures that the value corresponds to one of the four 
region codes. 


Even though it is not specified in our example, it is often desirable to validate the two- 
character state code. To do this, create a table of state codes as follows: 


create table us_states 

( 
state_abbrev char(2) primary key, 
state_name char(15) not null 


STATE_ABBREV STATE_NAME 
Alaska 
Alabama 
Arkansas 
Arizona 


Wisconsin 
Wyoming 


To validate the state code contained in the outlet table modify the state column 
declaration as follows: 


state char(2) not null references us_states, 


The references clause identifies that state is a foreign key of us_states. Any insert or 


update statement on the outlet table will ensure that the corresponding state does indeed 
exist. 


The on_hand table associates the product table with the outlet table identifying the 
number of units of a particular product item that is contained at a particular outlet. The 
on_hand table definition is given below. 
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create table on_hand 
( 
loc_id char(3) not null references outlet 
"warehouse containing this product", 


prod_id smallint not null references product 
"id of product at this warehouse", 
quantity int not null 
"units of product on hand at this warehouse" 


11.4 Indexes and Joins 


Indexes and pre-defined joins are capabilities that are solely designed to enhance 
database access performance. No SQL data manipulation statement refers directly to any 
index or join that has been specified in the DDL. Indexes and joins are used by the RDS 
SQL optimizer to generate an execution plan that will access the needed data as fast as 
possible. Your use of indexes and joins is crucial in determining the kind of performance 
that you will achieve from the RDS SQL system. 


11.4.1 Create Index 


An index provides the ability to quickly locate a row or rows of a table based on the 
values in the columns on which the index is constructed. Indexes are also used to pre- 
define frequently used sorting orders. The create index statement syntax is as follows: 


create [optional | unique] index index_name 


on base table name ( column name [asc | desc] [, column name [asc | desc]]... ) 
[in file_name] 


The create index statement creates an index on the specified columns in base_table_name. 
The index_name must be an identifier of not more than 32 characters. The index will be 
sorted in the order specified by the list of columns. Each index column can be in either 
ascending or descending order. 


The in clause can be used to identify the file that contains the index. If not specified, the 
index will be maintained in a separate file using the default page size (1024 bytes). 


All unique and primary key columns (except those of type rowid) must be indexed. If 
you do not specify a create index for a unique or primary key, the system will 
automatically create one for you. 


The selection of what needs to be indexed in a table requires careful consideration 
because indexes can consume a large amount of disk space. In general, you would create 
an index on those columns through which rows from a table would typically be accessed 
or sorted. 
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The sales_order table has two indexes. The order_key index is the one for the primary 
key. Since sales orders are often searched by date, an additional index is created on the 
ord_date column. 


create table sales_order 
( 
cust_id char(3) not null references customer, 
ord_num smallint primary key, 
ord_date date, 
ord_time time, 
amount double, 
tax real, 
ship_date timestamp 
) in salesd0; 
create unique index order key on sales order(ord num) in salek0; 
create index order ndx on sales order (ord date) in salekl; 


Indexes are not directly used from SQL but are utilized by the RDS SQL optimizer in the 
selection of an optimal access plan for retrieving data from the database. More indexes 
provide the optimizer with more alternatives and can greatly improve select execution 
performance. Unfortunately, the cost associated with a large number of indexes is the 
large amount of storage requirements and a high performance cost incurred by insert, 
update, and delete. Therefore, it is usually best to use discretion in choosing what to 
index. 


Optional indexes are indexes that can be deactivated. When an optional index is 
deactivated, the index is not used by the SQL system: insert statements will not store the 
key values and the optimizer will not use the index. When an optional index is active it 
operates just like any other index. The activate and deactivate index statements are 
used to enable/disable use of an optional index. The activate index statement will scan 
the associated table and store index values for those rows that do not have a 
corresponding key. The deactivate index statement simply marks the index as inactive. 
Existing key values remain unchanged. 


The implementation of optional indexes in SQL utilizes the optional key feature in the 
RDS DDL. If you are using this capability with a low-level RDS (i.e., "d_") API, it is 
important to note that the activation of an index occurs strictly at the SQL level. Thus, 
while an insert statement will automatically store the key values for an active optional 
index, the d_fillnew function will not. 


Optional indexes cannot be unique and are initially inactive. 


11.4.2 Create Join 


The performance of a join operation is an important consideration in deciding what 
needs to be indexed. Since all primary keys are indexed, access from the row containing 
a foreign key to the row containing the corresponding primary key entry is available 
through the primary key index. However, it is often better to be able to quickly access 
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the foreign key row from the primary key table. One method to do this would be to 
index the foreign key. Unfortunately, this will generally use large amounts of disk 
storage because there can often be many foreign keys associated with a single primary 
key. RDS SQL provides an additional feature designed especially for handling join 
operations between foreign and primary keys. The create join statement specifies that 
foreign and primary key relationships are to be maintained using direct access methods. 


The syntax for create join is as follows: 


create join join_name order {first | last | sorted} 
on base_table_name[( column namel, column name]...)] [sort cols] 
[and base table namel( column namel, column name]...)] [sort_cols]]... 


sort cols 


by column name [asc | desc] [, column name [asc | desc]]... 


The specified columns for each base table must have been defined as a foreign key 
(through the references clause) in the base table's create table. If no columns are listed, 
then the base table must have a single foreign key or references clause. If more than one 
base table is specified, each must reference the same table. Joins cannot be created 
between base tables in different databases. 


Specifying order sorted allows you to indicate the order in which those rows with the 
same foreign key values are to be stored. The sort columns must be specified with order 
sorted. Each column can be in either ascending or descending order. If more than one 
table is specified in the join, each of the corresponding sort columns between the tables 
must match in type and length. 


The create join guarantees that only a single logical disk access is needed to retrieve the 
related row in the referenced table. This means that the performance of referential 
integrity checking and select statement join processing will be optimal. It also 
guarantees optimal performance in locating all of the rows of the tables with a particular 
foreign key value and that the retrieval can occur from either the many-to-one or the one- 
to-many direction (thus, supporting both inner and outer join processing). No indexing 
of the foreign keys is needed to achieve this performance. 


The sample DDL below is from the sales database. 
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create table salesperson 
( 
sale_id char(3) primary key, 
sale name char(30) unique, 
commission float, 
mgr_id char(3) references salesperson 
); 
create unique index sale key on salesperson(sale id); 
create table customer 
( 
cust id char(3) primary key, 
company char(30) not null, 
street char(30), 
city char(17), 
state char(2), 
zip char(9) 
sale id char(3) not null references salesperson 
); 
create unique index cust key on customer(cust id); 


create join manages on salesperson(mgr id) order last; 
create join accounts on customer (sale id) order last; 


The salesperson table contains information about each salesperson. The primary key isa 
three-character code (sale id) that uniquely identifies each salesperson. The mgr id 
column is a foreign key definition that references that salesperson's manager. The mgr id 
for each manager is null. The customer table contains information about each customer. 
The primary key for each customer is also a three-character code (cust id). The 
salesperson who services a particular customer is identified by the sale id column in the 
customer table which is a foreign key referencing the primary key in the salesperson 
table. Primary keys must be indexed in RSQL. Thus, a create index statement is given 
for each of the two primary keys. In most SQL systems, that would typically be all that 
would be necessary to perform referential integrity checking. Join processing would 
most efficiently occur by accessing the referenced row (primary key) from the referencing 
row (foreign key). To efficiently access the other direction (which, by the way, is often 
the most natural—for example, "list all customers for a particular salesperson"), the 
foreign keys would also need to be indexed. This would result in a good deal of 
additional data redundancy. In RDS SQL, however, the create join statements result in 
the inter-table relationships being maintained directly to provide for optimal join 
processing. 
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As with indexes, discretion should also be used in deciding what foreign keys need to be 
pre-joined. Predefined joins are implemented using database address links stored in 
each row. There is also a cost associated with maintaining these links during execution 
of database modification commands. Tables that will often be joined and accessed from 
either of the two possible directions should be pre-joined. Where the access direction 
will only be from the foreign key to the primary keyed table, the primary key's index is 
usually sufficient to achieve acceptable performance. For example, it is not necessary to 
pre-join the us_states table shown earlier in this chapter to the foreign keys that 
reference it. 


11.5 Compiling an SQL DDL Specification 


RDS SQL provides two utility programs that you use to process RDS SQL DDL 
specifications. These programs are standard RDS applications that can be executed from 
any RDS client workstation. 


The RDS SQL Data Definition Language tools are used to compile an SQL DDL 
specification contained in a text file on the client computer and store the DDL 
information in the RDS SQL system catalog. Two utilities are provided. sddlp is the SQL 
DDL compiler that processes a RDS SQL DDL definition registering the new database on 
the RDS server. The ddigen utility can generate an RDS DDL specification or an ANSI- 
compliant SQL DDL specification for any database defined in the system catalog. 


The system catalog is itself an RDS SQL database that serves as a repository for all RDS 
SQL database definition information. Both utilities are standard RDS applications. The 
RDS server must be on-line for these utilities to operate. 


11.5.1 Executing the sddlp Utility 


The sddlp utility compiles a text file stored on the invoking user's client computer 
containing an RDS SQL DDL specification. This action generates the corresponding RDS 
DDL specification and automatically invokes the RDS ddlp program to compile it for use 
under RDS. Figure 11-1 illustrates sddlp operation. sddlp is composed of a client-side 
program that sends a copy of the SQL DDL specification file to an RDS extension module 
(sddlp EM) on the server. If there are no errors, the data definition information is then 
stored in the SQL system catalog and the corresponding RDS DDL specification is output 
to a temporary file. The RDS ddlp is invoked to process the RDS DDL, creating the RDS 
dictionary file. When finished, the temporary files are deleted. 
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Figure 11-1. sddlp Operation 


SQL SYSCAT 


The sddlp utility is invoked as follows: 


sddlp [-L server;user;password] [-abfilknopruw] [-d "ddlp opts"] ddlfile 


Each of the listed command line arguments are described in the following paragraphs. 


-L server;user;password 

This option is used to log in to the named RDS server using the specified user name and 
password. If not specified, sddlp will first check for an environment variable called 
RDSLOGIN defined as "server;user;password" and, if present, use the specified values. If 
it is not present, sddlp will prompt you for the login information. 
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-b 
This option will suppress display of the sddip copyright banner. 


-d "ddlp opts" 
This option can be used to pass through the RDS ddlproc command line options specified 
in "ddlp opts" to ddiproc when it is invoked by sddip . For example, 


sddlp -f -d "-00" dbname 


will pass the "-00" option to ddlproc and return dbname.ddl and dbname.hpp back to the 
client workstation. 


-f 

This option will cause sddlp to return to the client the RDS DDL file (dbname.ddl) and the 
header file that was created by the RDS ddlproc utility (either dbname.h or dbname.hpp). 
This option is for applications that use the low-level RDS API or Raima Object Manager. 
-i 

This option will cause sddlp to initialize the database. If the database being created 
already exists then the entire database will be reinitialized. By default, sddlp will 
initialize only the new database files if the database being created already exists. The 
existing files will remain intact. If the database does not already exist then all files will be 
initialized regardless of whether the -i option is specified 


-k 

Foreign key columns on which a create join has been declared and which are not 
indexed are defined by RDS SQL as virtual columns. That is, there is no actual RDS data 
field that corresponds to that column of the table. The user can access the values of that 
column just as they would any other, but RDS SQL will extract the data value 
automatically from the referenced (that is, the primary key's) row by using the RDS set 
with which the join is implemented. When all of the foreign keys that reference a 
particular primary key are virtual, RDS SQL allows the primary key to be modified, even 
if there are still active foreign keys that reference it. In all other cases, RDS SQL does not 
allow a primary key column to be modified unless there are no active references. This 
particular option can be used to turn off RDS SQL's creation of virtual foreign key 
columns. 


-n 
RDS SQL manages null column values through a hidden (to RDS SQL programs) RDS 
data field contained in each RDS record type definition. If an RDS SQL application does 
not need to use null column values, then this option can be used to suppress the creation 
of null column value indicator fields. 
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-0 

sddlp by default does not allow a database to be defined that does not exist in the SQL 
syscat but has already been registered with RDS. The assumption is that anon-SQL RDS 
database of the same name already exists. However, in order to delete old versions of a 
schema a "clean" syscat must be used, this condition could legitimately occur (see 
Rerunning SDDLP below). This option will allow the database definition to be accepted 
even when the database has been preregistered under RDS. 


-P 

The -p option causes sddlp to just pre-process the SQL DDL specification reporting any 
errors. No information is stored in the system catalog nor is the database registered with 
RDS. 


-r 

Full ANSI 1989 SQL referential integrity checking requires that every row that is 
referenced by each foreign key in the database exist. In order to enforce this integrity 
condition in the processing of a delete statement, RDS SQL maintains a reference count 
data field in each RDS record type that is referenced by a foreign key. Deletions to 
referenced rows are then only allowed when the count is zero. Of course, extra overhead 
is incurred to maintain these reference counts. This option allows the database designer 
to turn off the creation and use of these reference counts when they are not being used 
for a particular application. 


-u 
Sddip will fail if there is an existing database of the same name. The -u option can be 
used to indicate that the new schema is an update of an existing one. 


-w 
This option will cause sddip to display warning messages when non-standard SQL DDL 
features are encountered. 


ddlfile 
This is the name of the text file on the client computer containing the SQL DDL 
specification. 


Errors in the DDL specification will be reported on stderr. The system catalog is only 
updated when no errors are encountered and the -p option is not specified. The -w 
option will cause warning messages to be output when non-standard DDL features (such 
as create join) are used. 
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Since RDS SQL allows the definition of inter-database foreign key references it is 
necessary to run Sddlp on the referenced database definition prior to running sddlp on the 
referencing database definition. For example, both the salesperson table and the item 
table in the sales database contain foreign keys that reference tables in the inventory 
database. For these inter-database references to be set up properly it is necessary to run 
sddlp first on invntory.sql and then on sales.sql. 


When a new database has been successfully compiled, registered, and initialized by sddip 
it will not be available for use until RDS SQL has been shut down and restarted. RDS 
SQL shuts down when the last RDS SQL user disconnects. RDS SQL starts up when the 
first RDS SQL user connects. The RDS server itself does not need to be shut down—non- 
SQL RDS users are not affected. 


Rerunning SDDLP 


When you rerun sddlp on an existing database, a new version of the database is created. 
This new version has new id numbers assigned to the tables. Any views or stored 
procedures that existed on the prior version are invalidated by the new version. You will 
need to recreate those view and stored procedure definitions. Thus, it is best to save 
them in RSQL script files so they can be easily resubmitted after rerunning sddlp . (An 
RSQL script file is a text file containing RSQL commands and SQL statements that is 
invoked using the .r RSQL command, see Section 2.4) You should also save your grant 
statements in RSQL script files. 


Also note that when you rerun sddlp on a database that is referenced in other databases, 
you must rerun sddlp on the dependent databases as well. In order to remove the old 
versions of an SQL database definition from syscat, you need to start with a "clean" 
syscat and rerun sddlp on all of your SQL schema files using the "-o" option. A "clean" 
syscat is produced by reinstalling the SQL syscat from the RDS installation or by 
replacing the SYSCAT.0* files in the catalog directory with a copy of those files that you 
may have saved in a separate directory after installing RDS. After rerunning sddlp on 
the SQL schemas, you will need to reprocess (probably through RSQL unless you have 
your own program) your grant, create view, and create procedure statements that had 
been defined for those databases. 


The flow chart shown in figure 11-2 summarizes the steps for creating an RDS SQL DDL 
specification. 
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Create DDL spec. 
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text editor 


Rerun SDDLP 
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Database will be available for use 
when first RDS SQL user logs in 


Figure 11-2. Creating an SQL DDL Specification 


11.5.2 ddigen Utility 
The ddligen utility can be used to: 


e Create the RDS DDL specification for any database in the system catalog 


e Create a copy of the RDS SQL DDL specification for any database in the system 
catalog 

e Create an ANSI-compliant SQL DDL specification for any database in the system 
catalog 


The ddlgen utility is invoked as follows: 


ddlgen [-L [server;user;password] [-lsantb] [-v num] [-o outfile] dbname 
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-L server;user;password 

This option is used to log in to the named RDS server using the specified user name and 
password. If not specified, ddlgen will first check for an environment variable called 
RDSLOGIN defined as "server;user;password" and, if present, use the specified values. If it 
is not present, ddigen will prompt you for the login information. 


-l 
Lists the databases that are stored in the RDS SQL system catalog. 


-s 
This option will regenerate the RDS SQL DDL specification. By default, the output will 
be written to file dbname.sdl. 


-a 
This option is used with -s to specify that an ANSI-compliant SQL DDL specification is to 
be generated. 


-n 
The option will cause ddigen to suppress output of null column value indicator fields in 
RDS DDL record types. See discussion of the -n option under sddlp for more 
information. 


-t 

Some SQL systems require each statement to end with a semi-colon, others do not. By 
default, ddigen ends each statement with a semi-colon. This option will suppress 
ddigen's output of it. 

-b 

This option will suppress display of the ddigen copyright banner. 


-v num 
Use this option to generate the DDL for version num of database dbname. 


-o outfile 
Output the DDL (either RDS or SQL) to file outfile. 


dbname 
The name of the database whose DDL is to be generated. 


ddigen will create an RDS DDL file unless the -s option is specified. If the -s option is 
specified either an ANSI SQL (-a option) or an RDS SQL DDL specification will be 
generated. Fach SQL statement will be terminated by a semi-colon (;), unless this is 
suppressed using the -t option. 
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11.6 Temporary Tables and Indexes 


The DDL statements described so far in this chapter are used in the definition of 
permanent databases installed on the RDS server. In this release of RDS SQL these 
statements can only be processed using the sddlp utility as described in the last section. 
The RDS SQL server can, however, process create temporary table and create index for 
creating temporary tables and indexes. 


A temporary table is one that is created by a user to hold temporary results (usually from 
a select statement on a permanent database) from which additional queries will be 
processed. A temporary table is visible only to the user who creates it and it is 
automatically dropped by the system when the user disconnects. 


Indexes can be created on temporary tables. They must be specified before any rows are 
inserted into the table. 


The restricted syntax for create temporary table that is processed by the RDS SQL server 
is given below. The syntax for create index statements associated with temporary tables 
is as described in section 11.4 except that the in clause is not allowed for temporary 
indexes. 


create temporary table base_table_name 
column name type spec [, column name 


The column data types are the same as described in table 11-2. You cannot define any 
foreign or primary keys or check constraints. You can, however, specify default values. 
Temporary tables are simply composed of basic columns. 


A variation of the insert statement shown below is used to fill a temporary table. 


insert into table namel(column namel, column name]...)] [from] select statement 


There are no restrictions on the select statement. It can include order by, group by and 
subqueries as required. 


The example below illustrates the use of a temporary table called sp sales that will 
contain the customer orders processed by Sidney McGuire. 
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create temporary table sp_sales 
company char(30), 
city char(17), 
state char(2), 
ord_date date, 
amount float 


Lå 

create index skm ndx on Sp sales(state); 

insert into sp sales 
select company, city, state, ord date, amount 
from customer, sales order 


where customer.sale_id = "SKM" and 
customer.cust_id = sales_order.cust_id 
order by 1, 4; 


Note that the select in the insert statement contains an order by clause. This will cause 
the natural ordering of the rows in sp_sales to be sorted in company, ord_date order. 
Any query on sp_sales that does not itself have an order by specified will report its 
results in that same order. Including a create index statement allows ordering on that 
column without having to do a sort (for example, you may wish to include a group by 
statement in some queries). Other needed orderings could be supported by creating 
indexes on the columns that will result in the desired order. 


Besides using insert from select you could also use insert from file (see section 7.3.2) to 
fill a temporary table. 


Once you've filled a temporary table, you can use it just like any other table. You can 
even perform joins between the temporary table and a permanent table. 


If you need to reload a temporary table you can quickly re-initialize it using the initialize 
command. The following example uses the initialize command in reloading sp_sales, 
this time with Bob Flores' customers. 


initialize sp_sales; 
insert into sp_sales 
select company, city, state, ord_date, amount 
from customer, sales_order 


where customer.sale_id = "BNF" and 
customer.cust_id = sales_order.cust_id 
order by 1, 4; 


You could use delete from sp_sales to accomplish the same result as initialize but it 
could be considerably slower. 


You can issue a drop table command on the temporary table if you finish with it before 
you log out. For example, the following statement will delete sp_sales. 


drop table sp sales; 
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Chapter 12 
Advanced Topics 


12.1 Introduction 


This chapter provides information that is important for advanced use of the RDS SQL 
system. Topics that are addressed include: 

e Multi-user issues such as locking and transaction isolation modes 

e Query optimization 

e The RDS SQL system catalog 

e System administration 

e Low-level RDS database issues 


12.2 Multi-User Issues 


RDS SQL automatically controls locking of accessed rows during the processing of select, 
insert, update, and delete statements. There are several methods provided by RDS SQL 
that allow you to control the behavior of the locking operation. Two set statements are 
used to establish the desired multi-user operational behavior. 


set transaction isolation {on | off} 


set read repeatability {on | off} 


The effects of these two statements are described in table 12-1 below. 
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Table 12-1. Multi-User Control Settings 


transaction | repeatable | description 
isolation reads 


MT This is called read repeatability mode. Changes from other 


connections (users) are not visible until committed. All 
rows are locked. Read locks within a transaction are kept 


on 

until the transaction commits or is rolled back. 
on off Called cursor stability mode, this is the default mode for 
l 


RDS SQL. Changes are not visible to other connections 
until committed. A read lock is kept for the current row 
only. When the cursor is advanced to the next row the 
current row is freed. 
Allows dirty reads outside of a transaction whereby 
uncommitted changes from other connections are visible, 
but read locks are not required to read data from the 
Regardless of what mode you are in, all rows that are modified through execution of an 
insert, update, or delete statement are write-locked and remain so until the transaction is 
ended through either a commit or a rollback. Because of this, it is a good idea to keep 
the sizes of your transactions small. The more rows that are changed within a 
transaction, the more locks the server must manage. The overhead associated with this 
lock management could become excessive. A commit will free all of the write locks. 
Thus, short transactions can increase system throughput. 


database. Inside a transaction, behavior is identical to 
read repeatability mode. 
Allows dirty reads outside of a transaction whereby 
uncommitted changes from other connections are visible, 
but read locks are not required to read data from the 
database. Inside a transaction, behavior is identical to 
cursor stability mode. 


Read repeatability mode is the strictest form of transaction isolation available. In this 
mode, every row that is read within a transaction is read-locked and kept locked until the 
transaction ends. Thus, rows that are re-fetched inside a transaction are guaranteed to 
have the same values. 


Cursor stability mode is the RDS SQL system's default mode. In this mode, a read lock is 
placed on each row as it is fetched. When the next row is fetched, the lock on the current 
row is freed and the new row is locked. Thus, only the current row is locked at any time. 


So-called "dirty read" mode is useful in situations where the preciseness of the data is not 
particularly important. It could be used, for example, when you are looking for a 
particular row of a table of the "I'll know it when I see it" variety. Its advantage is that it 
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does not place any locks and, therefore, does not get blocked by any rows in its path that 
happen to be write-locked. 


The for update clause of the select statement requests that the system apply write-locks 
instead of read-locks to the rows of the result set. If no transaction is active when the 
statement is executed, SQL will automatically start a transaction. The select statement 
that contains the for update clause must be updatable (for a definition of updatable see 
discussion under create view in section 8.5). 


The for update clause follows the where clause in the specification of a select statement 
as shown in the following example. 


select * from salesperson where mgr_id is not null for update; 


The lock table and unlock table statements allow you to lock an entire table. Two lock 
modes are provided. Shared mode allows you (and others) read-only access to the table. 
Exclusive mode allows you to modify the table while denying all other users access to it. 
The syntax for lock table is shown below. 


lock table table_name [, table_name] [in] {share | exclusive} [mode] 
[table_name [, table_name] [in] {share | exclusive} [mode]]... 


Shared mode table locks can be freed explicitly with unlock table. All table locks are 
implicitly freed whenever a transaction is commited or rolled-back. 


For example, you can issue the following lock table statement to lock the salesperson 
and customer tables in shared mode and the sales_order and item tables in exclusive 
mode. 


lock table 


salesperson, customer share 
sales_order, item exclusive; 


A typical use for table locks is to place an exclusive lock on a table in order to do a bulk 
load, as illustrated in the following example which loads the inventory database from 
comma-delimited ASCII text files stored in the RDS catdev device. By the way, notice the 
update stats statement following the bulk load. It is always a good practice (in fact, it is 
mandatory on a new database) to execute update stats after making substantial 
modifications to a database to ensure that the optimizer (see next section) is generating 
access plans based on reasonable usage statistics. 


lock table product, outlet, on_hand exclusive; 

insert into product from file "product.asc" on catdev; 
insert into outlet from file "outlet.asc" on catdev; 
insert into on_hand from file "onhand.asc" on catdev; 
commit; 

update stats on invntory; 
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12.3 Query Optimization 


The task of a query optimizer is to determine the fastest way to access the database 
information needed to process a select statement (and, for that matter, update or delete). 
It does this by analyzing the tables used in the from clause, the conditions specified in 
the where clause, and the columns referenced in the group by or order by clause with 
the system's knowlege of the available indexes and pre-defined joins. A cost-based 
optimizer is one that utilizes data usage statistics to determine the best query execution 
plan. 


The RDS SQL query optimizer is a cost-based optimizer that uses the following 
information to estimate the cost of a particular access plan: 

e Number of pages in a file 

e Number of rows in a table 

e Number of distinct keys in an index 

e Depth of an index's B-tree 

e Number of rows per page 

e Number of keys per page 

e Index frequency distribution counts 


Figure 12-1 illustrates the process for compiling and optimizing a query. The SQL 
statement is compiled into an efficient internal form. The query transformation process 
eliminates any not operators (for example, not ord num < 2300 becomes ord_num >= 
2300) and ensures that all simple relational expressions have the column names on the 
left side of the relational operator and constants on the right side (for example, "BNF" = 
sale id becomes sale_id = "BNF"). 


The query is then analyzed by the optimizer using information from the system catalog 
such as the available indexes, predefined joins, and usage statistics. Possible access plans 
are generated and the one with the least cost is chosen. The resulting query is then 
packaged along with the access plan into a single executable query. 
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select collist from tablelist where conditon order by sortcols 


usage statistics: compile SQL syscat definitions: 
- page counts Statement - tables 

- row counts - indexes 

- index distribution - joins 


- index depth - foreign & primary keys 


compiled statement 


generate optimal 
access plan 


pack compiled 
statement 


executable SQL statement 


Fig. 12-1. Statement Compilation Process 


The database usage statistics are collected and stored in the system catalog through 
execution of the update statistics statement. Only administrator users and database 
owners can execute this statement. These usage statistics will be those used by the 
optimizer until the next time update statistics is executed. Therefore, it is a good practice 
to execute it fairly regularly until the database is large enough so that the statistics are 
representative of the distribution of data. 


Query optimizers do not resolve all possible problems. Queries that contain or'd 
conditions can be difficult or impossible to optimize. In many cases these can be 
rewritten into a form that the optimizer can process. For example, even if an index were 
available on the state column in the customer table, the optimizer would not use it with 
the following query. 


select ... from customer where state = "CA" or state = "WA" or state = 


"AZ" or state = "OR"; 
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However, for the equivalent query shown below the optimizer would use the index on 
state. 


select ... from customer where state in ("CA", "WA", "AZ", "OR"); 


Some or'd conditions are recognized by the optimizer, however. For the next query, the 
optimizer would use the index on ord num beginning at order number 2220 and read 
each index entry until ord num becomes > 2235, at which time the query would stop. 


from sales order where ord num >= 2220 and ord num <= 2235; 


This query can also be coded using the between operator as shown below. 
select ... from sales order where ord num between 2220 and 2235 


By formulating your queries as simply as possible, avoiding or, and making full use of 
the available relational operators such as in and between, the optimizer will be able to 
generate good execution plans. 


Order/Group By Index Support 


The RDS SQL optimizer will utilize any available indexes or sorted joins to retrieve rows 
in the order specified by an order by or group by clause. It is possible, however, that a 
much better access plan can be used, that even with the cost of doing a sort, will result in 
a much faster response. In those cases, the better plan will be used even though an extra 
sort step is required. 


Access Methods 


The RDS SQL optimizer can optimize all of the following predicates where column is 
indexed: 

e column {= | > | >= | < | <=} constant 

e column = column 

e column between constant and constant 


e column like "pattern", where the first character of "pattern" is not a wild card 
character ("%" or "_") 


e column in (constant [, constant]...) 


Tuning CPU Costs 


The RDS SQL query optimizer estimates the cost of a candidate access plan as the total 
number of logical I/O's required to execute the entire query. CPU time is factored in 
based on the number of candidate rows that are fetched but eliminated due to restrictions 
specified in the where clause. The CPU cost of evaluating the where for the additional 
candidate rows that are not part of the result set can be large. 
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RDS SQL factors in this CPU cost as a ratio of the number of candidate rows that can be 
checked per I/O. The default value is set to 5.35 rows per I/O. This was computed for 
an Intel 486/33 computer with a Norton SI disk rating of 8.2 (average seek time of 7.5 ms) 
and a CPU rating of 68 for an overall SI performance rating of 46.5. If your server 
computer is significantly different than this one you may need to adjust the value. If you 
have a lower disk rating then you should make the value higher (slower disk means 
more rows per I/O). If you have a slower computer but your disk is as fast (or faster) 
you should make the value lower. The optimizer may not be all that sensitive to this 
value, however. In one test, for example, the value had to be increased by an order of 
magnitude before a different plan was generated. Of course, other tests may be more 
sensitive. 


You can change the CPU ratio by issuing the following set statement. 


set cpu_ratio = constant; 


Only administrator users are allowed to issue this statement. 


If you wish to experiment with the values, you need to know the access plan created by 
the optimizer. Currently, there is no standard mechanism available in RDS SQL that 
allows a user to view the access plan for a query. There is, however, a built-in debugging 
capability that is available on the database server. If you set an environment variable 
called SQLDEBUG to 8 ("set SQLDEBUG=8") before starting the RDS server, SQL will 
output a copy of the execution plan for each SQL statement in successive files named 
debug.ddd (debug.000, debug.001, ++) located in the directory from which the server 
was started. We would not recommend that you do this in a heavily used system but 
you can use it to experiment with the optimizer. 


The set cpu ratio statement only changes the value for the session in which it is issued. 
To permanently change the system-wide default cpu ratio value an administrator can 
issue an update statement on the system catalog. For example, the following statement 
will change the default cpu ratio to 7.5. This value will not take effect until the server is 
restarted. 


update sysparms set cpu_ratio = L353 
commit; 


Failure to Improve Limits 


The time required to optimize a query grows exponentially with the number of tables 
specified in the from clause of the select statement. Up to about six tables, the time is 
negligible. For six or more tables, the time required to optimize becomes quite 
noticeable. The algorithm that is used by RDS SQL will often (but not always) determine 
the best access plan early in the optimization phase. Thus, the optimizer algorithm 
includes a failure-to-improve threshold limit based on the number of access plan step 
iterations. When the algorithm fails to generate a better access plan within the specified 
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limit, the optimizer stops and uses the best plan found up to that point. The number of 
iterations that the algorithm processes depends on the number of tables being accessed 
and the number of usable access methods that can be chosen. 


It is not atypical for the optimizer to execute several thousand iterations on a complex, 
multi-table query. By default, the optimizer's failure-to-improve threshold is 1000 
iterations. Reducing this value will result in faster optimization of complex queries but 
possibly at the risk of generating a less than optimal access plan. Increasing (or 
disabling) this value will improve the likelyhood of producing the best access plan. 


The following statement can be used to set the optimizer s failure-to-improve limit. 


set opt_limit = constant; 


The constant should be an integer value. Setting opt_limit to zero will disable the 
failure-to-improve check so that the optimizer will always run to completion checking all 
possible access plans. 


As with set cpu_ratio, only administrator users are allowed to issue the statement. 


The set opt_limit statement only changes the value for the session in which it is issued. 
To permanently change the system-wide default optimizer limit an administrator can 
issue an update statement on the system catalog. For example, the following statement 
will change the default failure-to-improve limit to 500. This value will not take effect 
until the server is restarted. 


update sysparms set opt_limit = 500; 
commit; 


Yielding Control to the RDS Scheduler 


As you might expect from the discussion in the previous section, the query optimizer is 
heavily CPU bound. It is not good in a server environment for any thread to consume a 
large amount of CPU time because that will block all other threads from making any 
progress. The RDS architecture is designed using a lightweight multiple thread 
technique that gives RDS complete control over the management of the threads. But 
since the RDS threads are only pre-emptable when a low-level RDS function is called, it is 
possible for a thread to tie up the server. 


The optimizer will periodically yield control to RDS after a specified number of 
iterations. Currently, the default is to yield after every 500 iterations. This value can be 
changed using the following statement. 
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set opt_yield = constant; 


The constant should be an integer value. Lowering the value will result in a smoother 
distribution of CPU time among all of the threads but will increase the system overhead 
required to swap control among the threads. 


As with the other set statements described in this section, this statement can only be 
issued by administrator users. 


The set opt_yield statement only changes the value for the session in which it is issued. 
To permanently change the system-wide default optimizer yield threshold an 
administrator can issue an update statement on the system catalog. For example, the 
following statement will change the default yield limit to 100. This value will not take 
effect until the server is restarted. 


update sysparms set opt_yield = 100; 
commit; 


12.4 System Catalog 


The RDS SQL system catalog contains all of the information about the definition of the 
databases that can be accessed from the RDS SQL system. The system catalog is created 
and updated by the sddlp utility (see Chapter 11) and the RDS SQL server. 


The RDS SQL system catalog is an RDS SQL database called syscat located in the catalog 
subdirectory. The SQL DDL specification for syscat is contained in file syscat.sql. The 
corresponding RDS DDL specification is in file syscat.vdl. The syscat database can be 
accessed by any RDS SQL user but it can only be modified by a qualified administrator 
user. 


Caution: MAKE ABSOLUTELY CERTAIN YOU KNOW WHAT YOU'RE DOING 
BEFORE YOU EXECUTE ANY DATABASE MODIFICATION COMMANDS ON syscat! 
erro  s,|E,Psevc“<“__ EEN UN syseat! © 


A diagram of a portion of the schema that shows the primary entities and relationships 
in syscat is given in figure 12-2. The boxes correspond to the RDS record types and the 
arrows correspond to the RDS sets. The double-lined connections between sysforkey, 
syskey and syscolumn represent an eight-element rowid array (called cols) contained in 
the sysforkey and syskey records. It is in cols that the rowids of the columns that 
comprise the foreign or primary key are stored. 
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sysdbhdr 


sysdbvers 


sysdbjoins sysdbindexes 


sysdbtables 


sysvals 


systables 


sysindexsort 


sysindexcol 


sysisortcols 


sysjoincol 


syscolumn 


sysjsortcols 


Fig. 12-2. RDS SQL System Catalog Schema Diagram 


A detailed description of the syscat database design is beyond the scope of this 
document. Some aspects of the more important elements are described so that syscat can 


be used by an application that needs to access information about the definition of a 
particular database. 


Basic table definition information is stored in table systable. A portion of the SQL 
specification for systable is shown below. 


create table systable 

( 
name char(32) "name of the table", 
dbid smallint "id of database that contains this table", 
tableid smallint "id number of this table", 


recid smallint "record id of corresponding RDS record type", 
colid smallint "column id of first syscolumn declared in this 
table" 


The following query will return a list of the tables that are contained in each of the 
databases in syscat. 
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select sysdbhdr.name, systable.name from path sysdbhdr to sysdb to 
systable; 


Information about each column is contained in the syscolumn table. A portion of its SQL 
DDL specification is as follows: 


create table syscolumn 

( 
name char (32) "name of column" 
dbid smallint "database identifier", 
tableid smallint "table identifier", 
colid smallint "column identifier", 


colno smallint "ordinal column number in table", 

fieldid longint "RDS DDL field id", 

data type smallint "SAG/ODBC data type value (for example, SQL_CHAR)", 

size smallint(3) "size of each array dimension", 

col_type smallint "0 = not specified, 1 = not null, unique, 3 = primary 
key", 


The following statement will display all of the columns in each table. 


select systable.name, syscolumn.name, 
from systable, syscolumn 
where systable.tableid = 


data_type, col_type 


syscolumn.tableid; 


Even though you can open and access syscat directly, RDS SQL through its ODBC 
interface provides standard functions for accessing syscat information. Function 
SQLTables and SQLColumns can be called to retrieve database table and column 
definition information. The primary advantage in using these calls instead of querying 
the syscat database directly is that they are part of a standard whereas our syscat 
database structure is not. Refer to the RDS SQL C Programmer's Guide for details on the 
use of these functions. 


12.5 System Administration 
12.5.1 SQL Configuration 


Most RDS system administration is performed using the RDS admin utility described in 
the RDS Administrator's Guide. Adding new users and devices and registering extension 
modules for use with SQL are performed using admin. However, you cannot register 
SQL databases through admin, as sddip does that automatically. 


Other capabilities provided by admin deal with configuration of the RDS database 
engine. These apply to both SQL and non-SQL databases served by the engine. 


SQL-specific configuration parameters are not currently serviced by the admin program. 
Administrator users can set these parameters through SQL by executing an update 
statement on the sysparms table in the syscat database. For example, issue the following 
statement to increase the maximum length of a string literal to 512 bytes. 
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update sysparms set maxstring = 5 123 

commit; 

It it important to note that THESE CHANGES WILL NOT TAKE AFFECT UNTIL RDS 
SQL IS RESTARTED ON THE SERVER. This restart occurs after the last SQL user has 
disconnected and the next SQL user connects. 


Table 12-2 describes the columns in sysparms that contain the default values for the SQL 
system parameters. 


p 
maxstring smallint | Specifies the maximum length of a string literal. Default is 
256 bytes. 
When more than maxsubqval rows are expected (or 
returned), the subquery will need to be evaluated for each 
maxprocs smallint | Specifies the number of stored procedures that can be cached. 
The default is 24. 
maxudfs smallint | Specifies the number of user-defined functions that can be 
cached. The default is 24. 
(meaning counts are kept for each 10% increment). Finer 
granularity will consume more server memory. 


maxsubqval | smallint | Sets the maximum number of correlated subquery result 
outer row. 
This parameter sets the granularity of the update stats index 


Table 12-2. SQL Configuration Parameters 
values that will be contained in memory. The default is 1024. 
maxviews smallint | Specifies the number of views contained in the SQL view 
cache. The default is 24. 
file distribution statistics histogram. The default is 10 


This parameter is a boolean. Set to 1 (default) means that 
maximum and minimum values for every column is 
maintained by SQL for use by the optimizer. Set to 0 turns 
off column stats saving 


(Continued) 
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(Continued) 


opt_yield integer | Sets the number of optimizer iterations before yielding to the 
RDS scheduler. Default is 500. 


Sets the optimizer failure-to-improve iteration limit. Default 
is 1000. 
Default is 5.35. 
Sets the maximum specifiable decimal precision. Default is 
32. 
locktime Sets the wait time in seconds before a read-lock will time out. 


Specifies the system decimal point symbol. Default is ".". 


thousymb Specifies the system thousands separator symbol. Default is 
char Specifies the "match all" like pattern matching symbol. 
Default is ANSI standard "%". 
char Specifies the "match any" like pattern matching symbol. 
Default is ANSI standard "_". 


date format Specifies the system date constant format. 1 = "MM-DD- 
YYYY", 2 = "YYYY-MM-DD", 3 = "DD-MM-YYYY". The 
default is 2 (SQL2 standard). 


Specifies the system date separator character. Default is "-". 


12.5.2 Security Logging 


All grant and revoke statements that have been executed are logged in the SQL syscat. 
The statements are tracked based on the user that issued the statement and the object on 
which the grant or revoke pertains. 


The following query will display security statements that have been issued by all users. 


select user_name, issued, txtln from sysseclog, systext 
where sysseclog.log_addr = systext.log_addr; 
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To find all of the security commands issued on database "SALES" use the query below. 


select syslookup.name, user name, txtln 
from syslookup, sysseclog, systext 
where syslookup.lookup addr = sysseclog.obj addr 

and sysseclog.log addr = systext.log_addr 

and syslookup.qual name = "SALES"; 


12.5.3 Retrieving View and Procedure Definition Text 


View and stored procedure definition strings can be retrieved from syscat. Each line of 
text in the definition is stored as a row in a table called systext and is related to either 
sysview (through a foreign key called view addr) or sysproc (through a foreign key called 
procid). For example, the following query will show the definitions of all views. 


select name, txtln from sysview, systext 
where sysview.view addr = systext.view addr; 


The query below will show the definition of a stored procedure called "SQLTABLES". 


select txtln from sysproc, systext 
where sysproc.name = "SQLTABLES" 
and sysproc.procid systext.proc_id; 


Issue the following select statement to find the view definitions that have been created 
by user "admin". 


select sysview.name, txtln from sysuser, sysview, 
where sysuser.name = "admin" 
and sysuser.name = sysview.owner name 


and sysview.view addr = systext.view addr; 


systext 


12.6 Low-Level RDS Database Issues 


This section provides information on how to access and manipulate RDS SQL databases 
using the low-level RDS d_ API. This information will also be useful to those migrating 
RDM applications to RDS SQL. 


The RDS SQL system is constructed as a layer on top of the RDS record-level application 
program interface. The low-level RDS interface is designed specifically for use from the 
C programming language and has its own Database Definition Language (DDL) that is 
modeled after C. The RDS SQL DDL is translated by sddlp into the RDS DDL equivalent. 
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Perhaps the best way to show how an RDS SQL DDL is mapped into the equivalent RDS 
DDL is by using an example. A sample SQL DDL specification for the inventory 
database is shown below. 


create database invntory; 
create table product 


( 


prod_id smallint primary key, 
prod_desc char(39) not null, 
price float 
cost float 


3 
create unique index prod_key on product (prod_id); 
create table outlet 


( 


loc_id char(3) primary key, 
city char(17) not null, 
state char(2) not null, 
region smallint not null 


j 
create unique index loc_key on outlet (loc_id); 
create table on_hand 


( 


loc_id char(3) not null references outlet (loc_id), 
prod_id smallint not null references product, 
quantity int not null 


); 
create join inventory order last on on hand(loc id); 
create join distribution order last on on hand(prod id); 


The corresponding RDS DDL specification is given below. Note that there is a one-to- 
one mapping of: 


e SQL to RDS database names 

e SQL files to RDS data or key files 

e SQL tables to RDS record types 

e SQL indexes to RDS compound keys 
e SQL joins to RDS sets 


Also note that, except for some missing and some added fields as discussed below, there 
is also a one-to-one correspondence between SQL columns and RDS fields. 
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record 


) 


record 


) 


) 


database invntory ( 
data file[1024] "invntory.000" 
key file[1024] "invntory.001" 
data file[1024] "invntory.002" 
key file[1024] "invntory.003" 
data file[1024] "invntory.004" 


product { 
char sysnulls_[1] [1]; 
long sysrefs_[1]; 


short prod_id; 

char prod_desc[40]; 
double price; 

double cost; 


contains product; 
contains prod_key; 
contains outlet; 
contains loc_key; 
contains on_hand; 


compound unique key prod_key { 


prod_id asc; 


} 


outlet { 

char sysnulls_[1] [1]; 
long sysrefs_[1]; 
char loc_id[4]; 

char city[18]; 

char state[3]; 

short region; 


compound unique key loc_key { 


loc_id asc; 


} 


on_hand { 
char sysnulls_[1] [1]; 
long quantity; 


set inventory { 


order last; 
owner outlet; 
member on_hand; 


set distribution { 


order last; 
owner product; 
member on_hand; 


The SQL columns that do not have a counterpart in the RDS DDL are foreign key 
columns on which a create join has been specified. For example, prod_id and loc_id are 
missing from the on_hand record type. The missing foreign keys are not needed because 
the values can be retrieved from the set owner record's primary key fields. If, however, 
there is an index that includes a foreign key column, then there will be a field in the 
corresponding RDS DDL record for it. 
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The additional fields contained in the RDS record types are sysnulls_ and sysrefs_. The 
sysnulls_ field is a bit map that is used to keep track of which columns in the table have 
null values. A zero bit means the column does not contain a null value. A one means 
that the column is null. The bits are assigned in the order in which the columns are 
declared starting with the high order bit position. The sysrefs_ field is defined for tables 
that are referenced by other declared foreign keys. This field contains a count of the total 
number of current foreign key rows that reference that row of the table. 


The disable null values and disable references count clauses of the create database 
statement can be used to disable either or both of these features, in which case sysnull_ or 
Sysrefs , respectively, will not appear. 


There are several capabilities that are available in RDS DDL that require special attention 
in RDS SQL DDL: 


e Key fields—all SQL indexes are mapped into RDS compound keys even 
when the index is composed of a single column. 


e Optional keys—can be declared using create optional index. 
e Struct fields—can be declared as c data types. 
e Array fields—can be declared as c data types. 


With these issues in mind, if you need to access an SQL database using the low-level RDS 
functions we recommend the following approach. 


1. Convert key fields to compound keys. If you are migrating an RDM database, you will 
need to convert all of your key fields to compound keys. Remove the key attribute 
from the field declaration and add a new, single field compound key to the end of 
the record for each key field. You may wish to have the compound key keep the 
original field name in which case you need to change the name of the data field. This 
way, for example, the d_keyfind calls in your program do not need to be changed 
nor do the key file statements in your DDL. Source code references to the data field 
itself, however, will need to be changed to the new name. Under RDM, rerun DDLP 
and then KEYBUILD to reconstruct the key files. 


2. Develop your DDL specification in SQL rather than RDS. For SQL to be able to access an 
RDS database, an SQL DDL specification must exist and be compiled using sddlp. 
RDS SQL cannot access low-level RDS databases. 
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Turn off the use of nulls and reference counts. If you will not be making any 
modifications to the database through the low-level RDS functions it may still be 
okay to have them turned on. If those features are enabled you must be sure that 
you do not make changes that will invalidate their use. 


Beware of changes that would violate SQL-defined check constraints. When you access an 
SQL database through the low-level RDS functions, the SQL-defined check clause 
constraints are not checked. This is why some relational database experts state that 
low-level access should never be allowed. There are, however, valid performance- 
related reasons why it may be necessary to use the low-level capabilities. But be 
careful that their use will not violate those constraints. 


Use VAL functions to manipulate SQL-specific data type values. The VAL functions are 
provided to allow a low-level RDS program to manipulate SQL values of type date, 
time, timestamp, and decimal. For details refer to the RDS SQL C Programmer's 
Guide. 


Understand the use of optional indexes under SQL. If you are migrating an RDM 
application that utilizes optional keys, be sure that you understand how SQL uses 
optional indexes because it may not conform to your use under RDM. Refer to 
section 11.4.1 for details. 


Use of c_data columns restricts SQL to read-only access. In this release, SQL tables that 
contain c_data columns cannot be modified through SQL statements (i.e., insert, 
update, and delete) -- all modifications to tables containing c_datacolumns need to 
be performed through the low-level RDS d_ API. For details refer to the RDS SQL C 
Programmer's Guide. 
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Chapter 13 


Language Reference 


13.1 Introduction 


This chapter contains a complete description of the RDS SQL language. The principal 
elements of SQL are defined, including identifiers, reserved words, constants, and 
expressions. The operational details for all RDS SQL statements are provided in 
alphabetical order in the statement reference section. 


13.2 Language Elements 
13.2.1 Identifiers 


Identifiers in RDS SQL are formed using a combination of letters, digits, and the 
underscore character, and always begin with a letter or an underscore. Identifiers can be 
from 1 to 32 characters in length. They are used to name tables, columns, indexes, joins, 
views, and stored procedures as well as other objects. They cannot, however, be 
reserved words (see section 13.2.2). RDS SQL does not distinguish between upper and 
lower case letters in identifiers. Thus, CUSTOMER, customer, and Customer all refer to 
the same object. 


13.2.2 Reserved Words 


Reserved words are pre-defined identifiers that have special meaning in the RDS SQL 
language. As with identifiers, RDS SQL does not distinguish between upper and lower 
case letters in reserved words. Table 13-1 lists the reserved words in RDS SQL. Some of 
the listed words are not described in this document but have been preserved for 
compatibility with other SQL systems. 


Language Reference 13-1 


abs 

acos 
activate 
age 
aggregate 
all 

and 

any 

as 

asc 
ascending 
ascii 

asin 

atan 
atan2 
authorization 
auto 

avg 
begin 
between 
binary 
break 
but 

by 

byte 
calculate 
cascade 
ceiling 
center 
char 
character 
check 
close 
column 
commands 
commit 
concat 
convert 


cos 

cot 

count 
cpu_ratio 
create 
curdate 
currency 
current 
curtime 
c_data 
database 
date 
dayofmonth 
dayofweek 
dayofyear 
db_addr 
deactivate 
dec 
decimal 
default 
delete 
desc 
descending 
disable 
display 
distinct 
double 
drop 
enable 
end 
exclusive 
exec 
execute 
exists 

exp 

file 

filter 

first 


Table 13-1. Reserved Words 


float 
floor 

for 
foreign 
from 
function 
functions 
grant 
group 
having 
hour 

if 

ifnull 

in 

index 
initailize 
insert 
int 
integer 
into 

is 
isolation 
join 

key 

last 
lcase 
left 
length 
like 
locate 
lock 

log 

long 
ltrim 
mark 
max 
member 
min 


minute 
mod 
mode 
money 
month 
noheader 
nosort 
not 

now 

null 
numeric 
of 

off 

on 

one 

open 
option 
optional 
opt limit 
opt yield 
or 

order 
output 
owner 
page 
pagesize 
path 

pi 
precision 
primary 
privileges 
proc 
procedure 
public 
quarter 
rand 

read 

real 


references 
repeat 
repeatability 
replace 
report 
restrict 
revoke 
right 
rollback 
rowid 
rtrim 

run 
scalar 
schema 
second 
select 

set 

share 
shared 
short 
show 
sign 

sin 

skip 
smallint 
some 
sorted 
sqrt 
statistics 
stats 
stogroup 
struct 
substring 
sum 
sysdate 
table 
tablespace 
tan 


temporary 
terminal 
text 
thousands 
through 
thru 

tid 

time 
timeout 
timestamp 
title 

to 

today 
trans 
transaction 
translate 
ucase 
unique 
unlock 
unsigned 
update 
use 

user 
using 
values 
varbyte 
varchar 
varying 
view 
week 
where 
width 
wild 

with 
work 

year 
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13.2.3 Constants 


A constant is a number or string value that can be used in an RDS SQL statement. 
Constants may be specified in various ways as described in the remainder of this section. 
Numeric Constants 


The RDS SQL numeric data types are smallint, integer, float, double and decimal. 
Numeric constants are formed as follows: 


Examples: 


If a constant is specified with a decimal portion (that is, [.digits]), the constant is stored as 
a decimal. If not, the constant is stored as an integer. 


Constants of type float can be entered using exponential format as shown below. 
[+ |-]digits[.digits]E[+ |-]ddd 

Examples: 

6.02E23 


1.8E5 
-3.776143E-12 


String Constants 


String constants are formed by enclosing the characters in the string inside single (' ') or 
double quotation marks (" "). If the string itself contains quotation marks, these must 
first be preceded by a backslash (\). Backslash characters can be included in a string by 
entering a double backslash (NN). 


Examples: 
"This is a string constant" 
"this string contains \"quotation\" marks" 


'this string contains a backslash (\\)! 


The default maximum allowed length of a string constant in RDS SQL is 256 characters. 
This values can be changed through as SQL configuration parameter (see Section 12.5.1). 
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Date and Time Constants 
The formats for date, time, and timestamp constants are shown in the following syntax 
chart. 


date_constant: 
date "YYYY-MM-DD" 
| @"[YYJYY-MM-DD" 


time_constant: 


time "HH:MM|[:SS[.ffff]" 


l @"HH:MM[:SS[.ffff]]" 


timestamp_constant: 
timestamp "YYYY-MM-DD HH:MMI[:SS[.ffff]]" 
| @"YYYY-MM-DD[ HH:MMI[:SS[. ffff]]]" 


The forms following the date, time, and timestamp key words conform to the SQL2 
standard. For date constants, YYYY is the year, MM is the month number (1 to 12), and 
DD is the day of the month (1-31). In this form, date constants must be specified with all 
four digits of the year. The "@" format is a non-standard alternative. In this form, a year 
that consists of only two digits is assumed to be in the current century. For time 
constants, HH is hours (0 to 23), MM is minutes (0 to 59), SS is seconds, and ".ffff" is the 
fractional part of a second of up to four decimal places of accuracy (if more than 4 places 
are specified, the value is rounded to only four places). A timestamp constant is simply 
the combination of the two formats. 


Three alternative date separator characters can be specified. Besides hyphen "-", the 
system will accept slash "/" and period ".". 


Some examples are given below. 


insert into sales order (ord num, ord date, amount) 
values(20001, €"93/9/23", 1550.00); 


insert into note 
values("HI-PRI", timestamp "1993-9-23 15:22:00", "SKM", "SEA"); 


select * from sales order where ord date >= date "1993-9-1"; 


insert into event (event id, event time) 
values ("Marathon", time "02:53:44.47"); 
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You can change the date constant input format using the set date default statement. This 


statement allows you to change both the order of month, day and year as well as the 
standard separator character. 


System Constants 


Three built-in literal constants are available in RDS SQL as described in the following 
table. 


Table 13-2. Built-in Constants 


| Constant | Description žĞž 

= A string literal equal to the name of the user that is executing the 
statement containing the user reference. 

A date literal that returns the current date at the time the statement 


containing the today reference is executed. 
A timestamp literal that returns the current timestamp at the time the 
statement containing the now reference is executed. 


The following examples illustrate the use of the built-in constants. 


- a statement that could be executed from an extension module or stored 
procedure 
that is always executed when an connection is made. 
insert into login_log(user_name, login_time) 
values(user, now); 


. check today's action items 
select cust id, note text from action_items where tickle date = today; 


13.3 Expressions 


13.3.1 Arithmetic and String Expressions 


Arithmetic expressions specify arithmetic evaluations to be performed on database 
values and constants. String expressions are specified as (possibly concatenated) string 


constants, columns, or functions. The syntax for formulating arithmetic and string 
expressions is given below. 
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expression: 
string_expr | arith_expr 
string_expr: 
string operand [^ string_operand] 
string_operand: 
"string" | [table_name.]column_name 
if (cond_expr , string_expr , string_expr ) 
string_function 
user_defined_function 


arith_operand [arith_operator arith_operand].. 


constant | [table_name.]column_name | arith_function | ( arith_expr ) 
arith_operator: 

+1-1*1/ 
arith_function: 


{sum | avg | max | min} ( arith_expr ) 
l count ( {* | [table_name.]column_name} ) 
| | if (cond_expr , arith_expr , arith_expr ) 
| | numeric_function | datetime_function | system_function 
| user_defined_function 


The operand of an expression can be a constant (described in section 4.5), a column 
reference, a function, or a parenthesized expression. 


| The column name may need to be qualified with a table or correlation name by prefixing 
the column name with the table name (for example, item.prod id). If there is more than 
one column in the resultant table with the same name, always qualify the column name 
with the table or correlation name. 


The operands of a string expression (string expr) are string constants, columns of type 
varchar or char, and string functions. The only valid operator is the caret (4), which 

| concatenates the operand strings. The supported string functions are described in Table 
13-3. 
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Table 13-3. String Functions 


Description 


ascii(strexp) Returns the ASCII numeric value of the initial 
character in strexp. 

char(num) Returns the character that has the ASCII code 
value of num where num is between 0 and 255. 

concat(strexp1, strexp2) Returns strexp concatenated to strexp1. 
(Same as using the ^ operator). 


insert(strexpj, num , num), strexp2) | Returns the string that results from replacing 
num) characters beginning at position num 
(first character is position 1, not 0) in strexpq 

with strexp». 


Icase(strexp) Converts strexp to lower case. 


left(strexp, num) Returns the leftmost num characters from 
strexp. 
length(strexp) Returns the length of strexp. 


locate(strexp1, strexp7, num) Returns the character position in strexp) where 
a string matching strexp begins. The search is 
made beginning at character position num 
(first character is position 1, not 0) in strexp». 
Returns 0 if strexp1 is not found in strexp». 


Itrim(strexp) Returns the string that results from removing 
all leading spaces from strexp. 

repeat(strexp, num) Returns the string that results from 
concatenating strexp to itself num -1 times. 


replace(strexp1, strexp9, strexp3) Returns the string that results from replacing 
all occurrences of strexp» in strexp with 
strexp3. Returns strexp, if strexp> is not in 
strexpq. 


right(strexp, num) Returns the rightmost num characters from 
strexp. 


(Continued) 
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(Continued) 


Returns the string that results from removing 
all trailing spaces from strexp. 


rtrim(strexp) 


Returns the substring of length num that 
begins in character position num (first 
character is position 1, not 0) of strexp. 


Converts strexp to upper case. 


The usual arithmetic operators can be used: "+" (addition), "-" (subtraction), "*" 
(multiplication), and "/" (division). RDS SQL evaluates arithmetic expressions in the 
order given in Table 13-4. Precedence goes from top (highest) to bottom (lowest). Items 
at the same level evaluate left to right. 


substring(strexp, num 1, num?) 


ucase(strexp) 


Table 13-4. Precedence of Arithmetic Operators 


Highest () Parenthetical expressions 
+,- Unary plus or minus 
+ Multiplication and division 
Lowest +,- Addition and subtraction 


=== 


Some examples of arithmetic expressions are shown below. 


sum(on hand.quantity * cost) 


if(quantity < 20, price, .9*price) 


(pi()*(radius/2.0) * delta)/1.414 


13.3.2 Calculation Functions 


Calculation functions perform computations on sets of rows that result from a select 
statement. The sets on which the computations are made are called aggregates. 
Aggregates are defined by either the group by clause of the select statement. There are 
five calculation functions. They are described in Table 13-5. 
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Table 13-5. Calculation Functions 


sum(arith_expr) Computes sum of results of specified expression for each 


p row of aggregate. 
avg(arith_expr) 
Computes maximum of results of specified expression for 


max(expression) 
all rows of aggregates. 
count({* | column_name}) | Computes count of all rows of aggregates. 


13.3.3 Conditional Selection Function 


Computes average of results of specified expression for all 
rows of aggregates. 


Computes minimum of results of specified expression for 
all rows of aggregates. 


The if function selects the expression to be evaluated based on a specified condition on 
each resultant row of the select statement. The syntax for the if function follows: 


if (cond_expr , expression, expression 


If the conditional expression (cond_expr) evaluates to TRUE, the function evaluates and 
returns the value of the first expression. If cond_expr evaluates to FALSE, the if 
evaluates and returns the value of the second expression. Both expressions must return 
values of identical data types: if the first expression returns a long result, the second 
must return a long result as well. Examples of the if function follow: 


select quantity, prod_id, prod_desc, 
if (quantity > 20, .8*price, if (quantity > 5, .9*price, price)) "PRICE" 
from item, product where item.prod_id = product .prod_id; 


update sales_order 

set tax = if(state="WA", amount*0.085, 
if(state="CO",amount*0.062,0.0)) 

where state in ("CA","WA"); 


select 
sum(if (prod id=10320, quantity, "386/20", 
sum(if(prod id=10333, quantity, "386/33", 
sum(if(prod id=10433, quantity, "486/33", 
sum(if(prod id=10450, quantity, "486/50", 
from item; 
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The following tables list the numeric, date/time, and system functions supported in RDS 
SQL. 


Table 13-6. Numeric Functions 


abs(arith_expr) Returns the absolute value of arith_expr. 


acos(arith_expr) Returns the arccosine of arith_expr (must be between 
-1.0 and +1.0) in radians.. 


asin(arith_expr) Returns the arcsine of arith_expr (must be between - 
1.0 and +1.0) in radians.. 


atan(arith_expr) Returns the arctangent of arith_expr (must be 


between -1.0 and +1.0) in radians 


atan2(arith expry, arith expry) Returns the arctangent of the specified x and y 


coordinates (each must be between -1.0 and +1.0) in 
radians.. 


ceiling(arith expr) Returns the smallest integer that is greater than or 
equal to arith expr. 


cos(arith expr) Returns the cosine of arith expr (value in radians). 


cot(arith expr) Returns the cotangent of arith expr (value in 
radians). 

exp(arith expr) Returns the exponential function of arith expr (that 
is, earith expr), 

floor(arith expr) Returns the largest integer that is less than or equal 
to arith expr. 


log(arith expr) Returns the natural logarithm of arith expr. 


mod(arith exprq, arith expr>) Returns arith exprj modulo arith expry (that is, the 
remainder that results from dividing arith exprq by 
arith expry). 


(Continued) 
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(Continued) 


Returns the value of pi as a double (3.14159...) 


Returns a random floating point number (between 0 
and 1) with integer num as the seed. If num is zero 
then the next random number for the current seed is 
returned. 


rand(num) 
Returns -1 if arith_expr is less than 0, 0 if arith_expr 


sign(arith_expr) 
equals 0, and 1 if arith_expr is greater than 0. 


sin(arith_expr) Returns the sine of arith_expr (value in radians). 
sqrt(arith_expr) Returns the square root of arith_expr. 
tan(arith_expr) Returns the tangent of arith_expr (value in radians). 


Table 13-7. Date/Time Functions 


curdate() Returns the current date. You can also use the today as a 

literal for the current date. 
Returns a time value of the current local (server) time. 

dayofmonth(date_expr) | Returns the day of the month in date_expr as a number 
between 1 and 31. 

dayofweek(date_expr) Returns the day of the week in date_expr as a number 
between 1 and 7 where 1 is Sunday. 

dayofyear(date_expr) Returns the day of the year in date_expr as a number 
between 1 and 366. 


(Continued) 
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(Continued) 


hour(time_expr) Returns the hour in time_expr (either a time or timestamp 
value) as a number between 0 and 23. 


minute(time_expr) Returns the minute in time_expr (either a time or timestamp 
value) as a number between 0 and 59. 


month(date_expr) Returns the number of the month in date_expr as a number 
between 1 and 12. 


Returns timestamp value for the current date and time. 


quarter(date_expr) Returns the number of the quarter in date_expr as a number 
between 1 and 4. 

second(time_expr) Returns the second in time_expr (either a time or timestamp 
value) as a number between 0 and 59. 

week(date_expr) Returns the number of the week of the year in date_expr as 
a number between 1 and 53. 


year(date expr) Returns the year in date expr. The earliest year for a RDS 
SQL date is 1 A.D. 


Table 13-8. System Functions 


convert(expr, type) 
convert(expr, char, width, "fmt") 


Description 


Convert expr to the specified data type. The 
second form converts expr to a character string that 
is formatted based on the format specifier "fmt". 


c_data(col[,dims][, elt dims]]) Extract element of c data column. 


database() Returns a string containing the name(s) of the 


database(s) that the session has open. If more than 
ifnull(exprj, exp2) 


one database is open, the names are separated by 
commas with no intervening spaces (for example, 
"sales,invntory,syscat"). 


If expry is null, expr is returned. If expr] is not 
null, expr] is returned. Both expressions must be 
compatible data types. 
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13.3.4 Using the Convert Function 


The convert function has two forms. The first form takes two arguments. The first 
argument is the expression to be converted. The second argument is the data type into 
which the expression is to be converted and is the data type of the resulting value. 


The valid types are as follows: 


e char 

e smallint(short) 

e integer (int) 

e real 

e float(double) 

e decimal(scale, precision) 

e date 

e time 

e timestamp 
The second form of the convert function takes four arguments and is only used where 
the result is char. The third argument specifies the size of the resulting character string. 


The last argument is a format specifier for numeric values or date /time values as 
described below. 


Both format specifiers begin with an optional justifier code. Code "<<" indicates that the 
text is to be left-justified in the specified display width. Code ">>" indicates right 
justification. Code "><" indicates that the text is to be centered. By default, numeric 
values are right-justified and date/time values are left-justified. 


Numeric Format Specifier: 


<< 1 >> I ><J['text' | SI-I QIE JHL AA. JJe LE] text" I $ 1 %]" 


The minimum you must specify in a numeric format is "#". If you want the thousands 
separated by the numeric separator ("," is the default), precede the "ft" with "#,". To 
indicate the number of decimal places to be shown, follow the "#" with "." followed bya 
"4" for each decimal place. The result will be rounded to the specified number of decimal 
places. 


Negative values are, by default, displayed with a leading minus sign (-). You can 
explicitly indicate this by preceding the leading "#" with a "-". Negative values can be 
enclosed in parentheses by preceding the leading "#" with an open parenthesis ("("). 
When negative values are enclosed in parentheses, positive values will have an ending 
space to ensure decimal point alignment. 
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If the display field width is not large enough to contain a numeric value, the convert 
function will format the value in exponential format (for example, "1.759263e08"). You 
can explicitly choose exponential formatting by specifying an "e" or "E" following the last 
Or: 


The result string can be prefixed or suffixed with the currency symbol or any text 
specified between single quotes ('). The suffix can alternatively be the percent sign (%). 
Some numeric format examples are shown in the following table. 


Table 13-9. Numeric Format Examples 


result 
convert(14773.1234, char, 10, "#.#") 
convert(736620.3795, char, 12, "#,4#.d###") 
convert(736620.3795, char, 12, "$#,#.##") " $736,620.38" 

convert(736620.3795, char, 8, "#.#####") 
convert(736620.3795, char, 12, "<<#.##HHHHte") 
convert(12201.10, char, 14, "DM '#,#.##") 


convert(-47893.357, char, 14, "$#,#.##") " $-47,893.36" 
convert(-47893.357, char, 14, "$(#,#.##") " $(47,893.36)" 
convert(47893.357, char, 14, "$(#,#.##") " $47,893.36 " 


convert(56.75, char, 8, "#.##%") " 56.75%" 
convert(56.75, char, 8, "#.##' percent) " 56.75 percent" 


The format specifier for date and time values is shown as follows: 


example format 


Date/Time Format Specifier: 
"[<< | >> | ><]['text' | <spec. char> | date code | time_code]..." 
date_code: 
m | mm | mmm | mon | mmmm | month | d | dd | ddd | dddd | day 
time_code: 


h[h][m[m][s[s][.f[f]...]]][a/ 


lam/pm|A/P|AM/PM] 
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As with numeric specifiers, date/time specifiers can begin with an optional justifier code. 
The remainder of the date/time format specifier can contain any number of text items 
(‘text'), special characters (for example, "-" or "/" or ".", etc.), date codes, or time codes. 
These items can be given in any order. 


The date format code descriptions are given in table 13-10. 


Table 13-10. Date Format Codes 


description 


month number without leading zero. 


month number with leading zero. 


three-character month abbreviation (for example, "Jan"). 


[mon fomes 
fully spelled month name (for example, "January"). 
day of month without leading zero. 


dd | day of month with leading zero. 
|ddd e| three-character day of week abbreviation (for example, "Wed"). 


dddd fully spelled day of week (for example, "Wednesday"). 
same as "dddd". 


two-digit year if date within current century otherwise year value AD. 
without leading zero. 
year value AD. without leading zero. 


3 


The time format codes are described in table 13-11. Each code can be interspersed with 
text items or special characters. For the minute codes to be interpreted as minutes (and 
not months), they must follow the hour codes. You cannot specify the minutes of a time 
value without also specifying the hour although you can specify hour by itself. Similarly, 
you cannot specify seconds without having specified minutes and you cannot specify 
fractions of a second without specifying seconds. Thus, the order "hours, minutes, 
seconds, fractions" must be preserved. 


E 
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Table 13-11. Time Format Codes 


hour of day without leading zero. 
hour of day with leading zero. 


minute of hour without leading zero (only after "h" or "hh"). 


[mm minute of hour with leading zero (only after "h" or "hh"). 


second of minute without leading zero (must follow "m" or "mm"). 


hh 
m 
mm 
s 
second of minute with leading zero (must follow "m" or "mm"). 
[f] 


fraction of second (must follow "s" or "ss"). RDS SQL maintains time 
accuracy to four decimal places but any number of decimal places may be 
specified (zero padded beyond four). 


Date and time format examples are provided in table 13-12 below. 


Table 13-12. Date/Time Format Examples 


mmm dd, yyyy Oct 23, 1951 
hh'hours' on "ddd month dd, yyyy O4hours on Tue October 23, 1951 


dd 'of' month 'of the year’ yyyy 23 of October of the year 1951 
dddd hh.mm.ss.ffff mm-dd-yyyy Tuesday 04.42.27.1750 10-23-1951 


‘date:'yyyy.mm.dd ‘at' hh:mm:ss date:1951.10.23 at 04:42:27 


13.3.5 User-Defined Functions 


User-defined functions are a very powerful capability of RDS SQL that allows you to 
write your own scalar and aggregate functions that can be referenced in any SQL 
expression. User-defined functions are written in C, reside in a dynamically loaded 
library (NLM on Netware, DLL on OS/2 and NT, shared library on UNIX) on the RDS 
computer, and are called from the SQL system. 
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To inform the SQL system about the presence of your user-defined function, use the 
create function statement as shown below. 


create [scalar | aggregate] function fcn_name ["description"] [, fen name ["description"] Je 
[[scalar | aggregate] function fcn name ["description"] [, fen name ["description"]...]... 
in diiname on devname ; 


This statement registers one or more user-defined functions contained in a dynamic 
library called dliname (NLM on Netware, DLL on OS /2 and NT, shared library on UNIX) 
that is stored on the RDS device devname in the RDS SQL system catalog. The name of 
each function must be a unique identifier of not more than 32 characters, An optional 
description may be specified with the function name. 


Each user-defined function (UDF) must be registered with RDS SQL so that it can be 
used. 


For example, the following statements create three user-defined aggregate functions that 
are contained in a DLL called statpack.dll on a RDS device named add_ins. The select 
statement calls the standard SQL aggregate function avg as well as the user-defined 
aggregate function geomean. 


create aggregate function 


devsq "compute sum of the squares of deviations", 
stddev "compute standard deviation", 
geomean "compute the geometric mean" 


in statpack on add_ins; 


select state, avg(amount), geomean(amount) from customer, sales_order 
where customer.cust_id = sales_order.cust_id 
group by state; 


UDFs can take any number of arguments of any type, and the value returned by a UDF 
can also be of any data type. 


Refer to the RDS SQL C Programmer's Guide for detailed information about how to write a 
UDF in C. 


13.4 Conditional Expressions 


Conditional expressions evaluate to true or false. They are used in the where and having 
clauses of the select statement and in the if conditional selection function. The reported 
rows of a select statement are those rows in which the conditional expressions specified 
in any where and having clauses have evaluated to TRUE. Shown below is the syntax 
for formulating conditional expressions. 
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13-18 


rel_expr [bool_oper rel_expr]... 


expression [not] rel_oper 

{expression | [{any | some} | all] (subquery)} 
expression [not] between constant and constant 
expression [not] in {(constant [, constant]...) | (subquery)} 
[table_name.]column_name is [not] null 

string_expr [not] like "string" 

not rel_expr 

( cond_expr ) 

[not] exists (subquery) 

[table_name.]column_name *= [table_name.]column_name 
[table_name.]column_name =* [table_name.]column_name 


select {* | expression} from {table_list | path_spec} 
[where cond_expr] 


(equal) 

(less than) 

(greater than) 

(less than or equal) 

(greater than or equal) 
= | /= (not equal) 


& | && | and (true if both operands are true) 
"VL "1 1 | or (true if one or both operands are true 
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A conditional expression is a sequence of one or more relational expressions separated by the 
boolean operators and and or. Relational expressions perform a comparison between 
expressions that evaluate to TRUE or FALSE (see section 13.3.1, "Arithmetic and String 
Expressions"). A relational expression can also be a parenthesized conditional 
expression. Table 13-13 applies two arbitrary relational expressions, r1 and r2, to each of 
the boolean operations and lists all possible results. 


Table 13-13. Boolean Operation Results 


r1 bool oper r2 


rl r2 and or 
true true true true 
true false false true 
false true false true 
false false false false 


===" 


The usual relational comparison operators (for example, "=", "<", ">") compare the 
P 
results of two expressions. 


The between operation will check that the specified arithmetic expression returns values 
inclusively within a given range of values. 


The in operation evaluates to true when the value of the expression is contained in a 
specified list of values. 


The like operation allows wild-card checking of string expressions: a "_" in the check 
string will match any single character and a "%" in the check string will match zero or 
more characters (these match characters can be changed using the set wild statement). 
The specified expression must return a string result. 


The is [not] null checks for null column values. Null column values result when 1) the 
value is actually null, or 2) the related row of an outer join does not exist (thus, all 
columns in the related row are null). 


The *= (=*) operators specify that a left (right) outer join is to be performed on the 
specified columns. 
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Some example conditional expressions as used in the where and having clauses of a 
select statement are given below. 


select company, amount from customer, sales_order 
where customer.cust_id = sales order.cust id and 
(amount >= 10000 or company = "IBM"); 


select company, city from customer where state in ("AZ","CA","OR", "WA"); 


select company, city, state, phone, amount from salesperson, customer 
where company like "%Computer%" and amount between 10000 and 50000 
and customer.sale id = salesperson.sale id; 


select sale name, commission*sum(amount) 

from salesperson sp, customer CcC, sales order so 

where sp.sale id = c.sale id and c.cust id = so.cust id 
group by 1 nosort having commission*sum(amount) <= 1000; 


select sale name "SALESPERSON", company "PROSPECT LIST" 
from path salesperson to customer to sales order 
where ord num is null; 


select sale name, company from salesperson, customer 
where salesperson.sale id *= customer.sale id; 


13.5 Subqueries 


Subqueries allow SQL statements to restrict where clause results based on the evaluated 
result of a select statement nested within the SQL statement. Four types of subqueries 
can be specified as shown below. 

1. expr relop (select expr from ...) 

2. expr relop {any | all} (select expr from ...) 

3. expr [not] in (select expr from ...) 

4. [not] exists (select * from ...) 


Subqueries of the first type can only return a single value. For example, the following 
query will return all sales orders for which the total amount of the order is better than 
average. Here, the subquery returns only the single value. 
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select * from sales order 
where amount > (select avg(amount) from sales order) 


Subqueries of the second type can return multiple rows. A quantifier is used to 
determine whether the relational operation applies to all rows or to any (at least 1) row 
from the result set (some can be used instead of any, if desired). For example, the 


following query will return all sales orders by salesperson for those orders that are larger 
than all orders booked by salespersons managed by SSW. 


select sale_name, ord_num, ord_date, amount 
from salesperson, customer, sales_order 
where salesperson.sale_id = customer.sale_id and 

customer.cust_id = sales_order.cust_id and 

amount > all 

(select amount from salesperson sp, customer c, sales_order so 

where sp.sale_id = c.sale_id and c.cust_id = so.cust_id and 

mgr_id = "SSW"); 


Subqueries of the third type are simply a different way of writing type 2 subqueries. 
Thus, "expr in (select ...)" is the same as "expr = any (select ...)" and 

"expr not in (select ...)" is the same as "expr <> all (select ...)". Subqueries of the fourth 
type do not return any rows but simply return TRUE if the subquery returns at least one 
row or FALSE if no rows are found. For example, assuming that the sale_id column in 
the customer table was an undeclared foreign key to the salesperson table, the following 
update statement would use an exists subquery to ensure that the referenced salesperson 
did indeed exist. 


update customer set sale_id = "CMB" 
where cust_id = "SEA" and 
exists (select * from salesperson where sale_id = "CMB"); 


Subqueries may themselves contain subqueries. RDS SQL does not impose any arbitrary 
limits on how deep the nesting can go. 


Sometimes a subquery needs to refer to a column from the outer query. These column 
references are called outer references, and subqueries that contain them are called correlated 
subqueries. The following example shows orders by salesperson that are larger than all of 
the orders booked by non-manager salespersons who are managed by someone else. 
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select sale_name, mgr_id, ord_num, ord_date, amount 
from salesperson spl, customer cl, sales order sol 
where spl.sale_id = cl.sale_id and cl.cust_id = sol.cust_id and 
spl.mgr_id is not null and 
amount > all 
(select amount from salesperson sp2, customer c2, sales_order so2 
where spl.mgr_id != sp2.mgr_id and 
sp2.sale_id = c2.sale_id and c2.cust id 


= so2.cust id); 


This query requires that those rows from the inner query that have the same manager as 
the outer query be excluded from the subquery. To do this a correlation name (for 
example, sp1 and sp2) must be supplied for each separate salesperson table reference to 
distinguish between the inner and outer salesperson tables. 


13.6. RDS SQL Statement Reference 


This section contains complete descriptions of all RDS SQL language statements. The 
name and a short description of each statement are provided in the page headings. The 
statement description pages are provided in alphabetical order for easy reference. Å 
summary of the syntax of the statement is provided and all operational details relating to 
each of the statements are given. 


The statement type entry indicates if the statement is a Data Definition Language (DDL) 
statement or a Data Manipulation Language (DML) statement. DDL statements can only 
be processed by the sddlp utility, and DML statements by the server. Note that some 
ANSI DDL statements are classified here as DML statements because they are processed 
by the database server and not by sddlp. 


Example statement specifications illustrate the use of each statement. The following table 
gives a summary of the RDS SQL statements. 
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Table 13-14. RDS SQL Statement Summary 


Statement Description 

Activate an optional index. 

Begin database modification transaction. 

Close database(s). 

Commit database modifications made during transaction. 
Create new database definition. 

Create database file to contain table or index. 

Create a user-defined function declaration. 

Create an index on columns in a table. 


create join..............00000.. Create a join between a foreign and primary key. 
create procedure.......... Create a stored procedure. 

create table.................. Create a database table. 

create temporary table Create a temporary table. 

create view ............00..... Create a view. 

deactivate index........... Deactivate an optional index. 

delete... unavsskalåt Delete row(s) from a table. 

drop procedure ............ Drop a stored procedure. 

drop table.............0..00.. Drop a temporary table. 

drop view...............0.0. Drop a view. 

execute Execute a stored procedure. 

grant........ Grant user permissions. 

1 Insert row(s) into a database table. 

lock table ............0..000. Lock table for shared/exclusive access/ 
Malkina -Mark a transaction rollback point. 

OPEN oo... Open database(s). 

revoke ............0.... ... Revoke user permissions. 
rollback... eee Discard all changes made since a transaction mark or start. 
select usnudlnsig: Retrieve selected columns and rows from one or more tables. 
set cpu ratio... Set the number of rows per i/o for optimizer. 

set currency ................. Set currency symbol. 

set date default............. Set the default date input constant format 


set decimal Set decimal point character. 


set display Set default data type display format. 

set numeric separator. Set numerical (thousands) separator character. 
set opt_limit.................. Set the optimizer's failure-to-improve limit. 

set opt yield................. Set the optimizer's system yield limit. 


set read repeatability... Set transaction read repeatability mode. 
set transaction isolation Specify transaction isolation mode. 


set wild.........rrrrrrrrrnvvrnnre Update row(s) of a table. 
unlock table.................. Free share locks on specified tables. 
update ............. ee Update row(s) of a table. 


update statistics........... Update usage statistics on specified databases. 
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activate index 


Activate optional index 


activate index Activate optional index 
Syntax activate [optional] index index_name 


Statement Type DML 


Description This statement activates an optional index. Optional indexes are 
indexes that can be deactivated. When an optional index is 
deactivated, the index is not used by the SQL system: insert 
statements will not store the key values and the optimizer will not 
use the index. When an optional index is active it operates just like 
any other index. The activate and deactivate index statements are 
used to enable/disable use of an optional index. 


The activate index statement will lock and scan the table associated 
with the index and store index values for those rows that do not 
have a corresponding key. 


The SQL query optimizer will only utilize active indexes. If a view 
or stored procedure is executed that uses an inactive index, SQL 
will return an error code (errACTINDEX, 14039) indicating the 
condition. 


See Also create optional index, deactivate index 


Example 


deactivate index search keyl; 
deactivate index search key2; 
lock table lookup table exclusive; 


insert into lookup table from file "newrows.txt" on mydev; 
commit; 

activate index search keyl; 

activate index search key2; 


13-24 Raima Database Server SQL Language Guide 


begin 
Begin database transaction 
————————————=—— CO PEIN database transactior 


begin Begin database transaction 


Syntax begin [trans | transaction | work] [trans_id] 


Statement Type DML 


Description This statement can be used to mark the beginning of a transaction. 
Standard SQL specifies that the beginning of a transaction occurs 
just after a user has opened a database, and after a commit for a 
prior transaction has completed. Thus, use of begin is not required, 
but it allows the user to name specific transactions and to clearly 
delineate the portions of an SQL program or procedure that modify 
the contents of a database. The transaction is defined by the SQL 
statements processed between begin and commit. 


Once a transaction is started another transaction cannot be started 
in the same connection until the active transaction has been 
terminated by a commit or rollback statement. 


Any statements that can change the contents of a database must be 
bounded by transactions and are put into effect only through the 
execution of the corresponding commit statement. Once 
committed, the changes become a permanent part of the database. 


A transaction identifier can be specified if desired, and may 
optionally be referenced in the commit or rollback statements. 


See Also commit, mark, rollback 
Example 


begin trans new_salesperson; 

insert into salesperson 
values("SBB", "Scott Blades", 0.80, "West", 1, "MCK"); 

commit trans new_salesperson; 
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close 
Close database(s) 


owe $$ 


close Close database(s) 


Syntax close dbname [, dbname]... 


Statement Type DML 


Description The close statement closes the specified databases. The close is not 
allowed if there is an active transaction.. 


See Also open 
Example 


open sales, invntory; 
. access databases 


close sales, invntory 
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commit 
Commit database modifications made during transaction 


commit Commit database modifications made during transaction 


Syntax commit [trans | transaction | work] [trans_id] 


Statement Type DML 


Description The commit statement causes all changes made since the beginning 
of a transaction to be made permanent. If a transaction identifier 
(trans_id) is specified, it must be the same as the one specified on the 
most recently executed begin statement. 


Note that a transaction starts with the first begin or the first 
command that modifies the database following database open ora 
commit or rollback statement. 


Any statements that can change the contents of a database must be 
bounded by transactions and are put into effect only through the 
execution of the commit statement. Once committed, the changes 
become a permanent part of the database and they can no longer be 
rolled back. 


See Also begin, mark, rollback 
Example 


begin work new_salesperson; 


insert into salesperson 
values("DMM", "Mayes, Doug", 0. "DEN", "BNF"); 


commit work new salesperson; 


insert into salesperson 
values("MMT", "Thomas, Mike", | "ATL", "GAP"); 


commit work; 
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create database 
Create new database definition 


ee aa mm 


create database Create new database definition 


Syntax create (database | schema authorization) dbname 


[on device name] 
[{enable | disable} null values] 
[{enable | disable} references count] 


Statement Type DDL 


Description This statement is used to create a new permanent database or a new 
version of an existing database. The database will be defined by 
subsequent create file, create table, create index, and create join 
statements. 


The on clause can be used to specify the name of an RDS device on 
which the database files will be stored. If not specified, the database 
files are stored on the issuing user's device. The specified device 
name must exist on the RDS server. For information about how to 
create devices refer to the RDS Database Administrator's Guide. 


The null values clause can be used to enable (default) or disable use 
of null values. RDS SQL manages null column values through a 
hidden null value indicator column contained in each table. If an 
RDS SQL application does not need to use null column values then 
this feature can be disabled. Note that this can also be controlled 
through an sddip command line option. The presence of this clause 
supersedes the sddlp option. 


Full ANSI SQL referential integrity checking requires that every 
row that is referenced by each foreign key in the database exist. In 
order to enforce this integrity condition in the processing of a delete 
statement, RDS SQL maintains a hidden reference count column in 
each table referenced by a foreign key. Deletions to referenced rows 
are allowed when the count is zero. Of course, extra overhead is 
incurred in order to maintain these reference counts. The disable 
references count clause allows the database designer to disable the 
creation and use of these reference counts when unnecessary for a 
particular application. When disabled, it will not be possible to 
delete rows from tables that are referenced by foreign keys on 
which a create join has not been defined. (To allow deletion would 
require the system to impose severe performance penalties in order 
to preserve referential integrity.) Note that this feature can also be 
controlled through an sddip command line option. The presence of 
this clause supersedes the sddlp option. 
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create database 
Create new database definition 
—_ CS VF al NEW database detinitior 


Note: The schema authorization alternative is given for ANSI SQL 
compatibility. 
== 


See Also ; . ext 
create file, create table, create index, create join 


Example 


create database invntory; 

create table product ( 
prod_id smallint primary key, 
prod_desc char(40) 


); 
create unique index prod key on product (prod id); 
create table on hand ( 

quantity int not null, 

prod id smallint not null references prod id 


Er 
create join distribution order last on on hand (prod id) 


r 
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create file 


Create database file to contain table or index 


create file 


Syntax 


Statement Type 


Description 


13-30 


Create database file to contain table or index 
create {file | tablespace} file_name [pagesize bytes] [on device_name] 


DDL 


The create file statement can be used to define a database file that 
will contain database tables or indexes. 


The size of the database page for each file can be specified. The 
default page size is 1024 bytes. A file can contain one or more tables 
or one or more indexes. However, a given file cannot contain both 
tables and indexes. The contents of a file are specified through use 
of the in clause of the create table and create index statements. The 
file_name is an identifier which must be unique. from all other files 
in this database. Use of the create file statement is not required. If 
not used, the contents of each table are stored in a separate file with 
the default page size. 


The on clause can be used to specify the name of an RDS device on 
which the file will be stored. If not specified, the file is stored on the 
database's device. The specifed device name must exist on the RDS 
server. For information about how to create devices refer to the 
RDS Database Administrator's Guide. 


The system automatically assigns the physical file names from the 
first eight characters of the database name and a three-digit file 
extension beginning with dbname.000 for the first file, dbname.001 for 
the second, and so on. 


The maximum number of files in a database is 256. This includes all 
files defined with create file as well as all tables and indexes for 
which an in clause has not been specified. 
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create file 
Create database file to contain table or index 
SS). ANN ERIN eM ase The to Contain table or index 


See Also | Kr 
create database, create table, create index, create join 


Example 


create database invntory; 
create file invprod; 
create file invcount; 
create file invindex; 
create table product ( 
prod_id smallint primary key, 
prod desc char (40) 
) in invprod; 
create unique index prod_key on product (prod_id) in invindex; 
create table on_hand ( 
quantity int not null, 
prod_id smallint not null references prod_id 
) in invcount; 
create join distribution order last on on hand(prod id) 


r 
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create function 
Create user-defined function definition 


create function Create user-defined function definition 


Syntax 


create [scalar | aggregate] function name_list 
[[scalar | aggregate] function name list]... 
in libname on devname ; 


name list 
fen name ["description"] [, fen name ["description"]... 


Statement Type DML 


Description This statement registers in the RDS SQL system catalog one or more 
UDFs contained in a dynamic library called libname.dll (on OS/2 or 
Windows NT; libname.nim on Netware) that is stored on the RDS 
device devname. The name of each function must be a unique 
identifier of not more than 32 characters. An optional description 
may be specified with each function name. 


The function is identified as either a scalar function (default) or an 
aggregate function. A scalar function returns a single value for a 
single row. An aggregate function returns a single value that is the 
result of a calculation on a group of rows based on the group by 
clause of the select statement. 


By the way, you can use functions (plural) instead of function in 
the statement. 


A UDF must be registered with create function before it is used. 


See Also drop function, RDS SQL C Programmer's Guide 
Example 
create scalar function 


baseline "return baseline constant" 
aggregate functions 


devsa "compute sum of the squares of deviations", 
stddev "compute standard deviation", 
geomean "compute the geometric mean" 

in statpack on add ins; 
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create index 
Create an index on columns in a table 


—-Ww mS EAS Må (ADIGE 


create index Create an index on columns in a table 


Syntax create [optional | unique] index index name 


on base table name( column [asc I desc][, column [asc | desc]]...) 
[in file_name] 


Statement Type DDL or DML 


Description The create index statement creates an index on the specified 
columns in base_table_name. The index will be stored in the order 
specified by the list of columns. Each index column can be in either 
ascending or descending order. 


You can send a create index statement to the RDS SQL server in 
order to specify an index for a temporary table. The create index, 
however, must be specified before you insert any rows into the 
temporary table. RDS SQL does not support dynamic index 
creation. 


The in clause can be used to identify the file that contains the index. 

If not specified, the index will be maintained in a separate file using 

the default page size (1024 bytes). The in clause cannot be specified 
if you are creating an index on a temporary table. 


All unique and primary key columns (except those of type rowid) 
must be indexed. If you do not specify a create index for a unique 
or primary key, sddlp will automatically create one for you. 


The optional attribute is used to define an index that can be 
deactivated. When an optional index is deactivated, the index is not 
used by the SQL system: insert statements will not store the key 
values and the optimizer will not use the index. When an optional 
index is active it operates just like any other index. The activate 
and deactivate index statements are used to enable / disable use of 
an optional index. The activate index statement will scan the 
associated table and store index values for those rows that do not 
have a corresponding key. The deactivate index statement simply 
marks the index as inactive. Existing key values remain unchanged. 
This feature cannot be specified if you are creating an index on a 
temporary table. 
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create index 
Create an index on columns in a table 


See Also ; : 2 i , 
activate index, create join, create table, deactivate index 


Example 


create database invntory; 
create table product ( 
prod_id smallint primary key, 
prod_desc char(40) 
VG 
create unique index prod key on product (prod id); 
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create join 


Create a join between a foreign and a primary key 
c LL Been a foreign and a primary key 


create join Create a join between a foreign and a primary key 


Syntax create join join_name order {first | last | sorted} 


on base_table_name[( colname[, colname]...)] [sort_cols] 
[and base_table_name[( colnamel, colname]...)] [sort cols]]... 


sort cols 
by colname [asc | desc] [, colname [asc | desc]]... 


Statement Type DDL 


Description The create join statement is used to specify a pre-defined natural 
join which will be maintained by RDS SQL on each insert, update, 
and delete operation. 


The specified columns for each base table must have been defined 
as a foreign key (through the references or foreign key clause) in 
the base table's create table. If no columns are listed, then the base 
table must have a single foreign key or references clause. If more 
than one base table is specified, each must reference the same table. 
Joins cannot be created between tables in different databases. 


The order sorted clause allows you to specify the order in which 
those rows that have the same foreign key values are to be stored. 
The sort columns must be specified with order sorted. Each column 
can be in either ascending or descending order. If more than one 
member table is specified in the join, each of the corresponding sort 
columns between the tables must match in type and length. 


The foreign key columns which are defined in a join are virtual 
columns—columns that do not actually contain any data. In other 
words, the foreign key's column values come from the primary key 
of the referenced table. No redundant data is required. If, however, 
the foreign key column is used in an index then the foreign key 
column is real and redundant data will be maintained in the 
referencing (foreign key) table. 
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create join 
Create a join between a foreign and a primary key 


Vitale å eee 


The create join guarantees that only a single logical disk access is 
needed to retrieve the related row in the referenced table. This 
means that the performance of referential integrity checking and 
select statement join processing will be optimal. It also guarantees 
optimal performance in locating all of the rows of the tables with a 
particular foreign key value, and that the retrieval can occur from 
either the many-to-one or the one-to-many direction (thus 
supporting both inner and outer join processing). No indexing of 
the foreign keys is needed in order to achieve this performance. 


See Also , 
create index, create table 


Example 


create table salesperson 
( 

sale_id char(3) primary key, 

sale_name char(3) not null, 

commission float, 

region smallint, 

mgr_id char(3) references salesperson" 
); 
create unique index sale key on salesperson(sale id); 
create table customer 
( 

cust id char(3) primary key, 

company char(30) not null, 

street char(30), 

city char(17) 

state char(2) 

zip char(2), 

phone char(2) not null, 

sale id char(3) not null references salesperson 


, 
, 


3 
create unique index cust_key on customer (cust_id) ; 
create join accounts on customer(sale_id) order last; 
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create procedure 


Create a stored procedure 
—_!——!..- SSCS Fate’ a stored procedure 


create procedure 


Syntax 


Statement Type 


Description 


Language Reference 


Create a stored procedure 


create {proc | procedure} proc name [(arg_spec [, arg spec]...)] 
SQL statement [;] [SQL statement Elk 
end {proc | procedure} ; 


arg_spec: 
arg_name type_spec [default constant] 


type_spec: 
integer | smallint | real | float | decimal 
{char | character} | date | time | timestamp 


DML 


Stored procedures allow the user to define a single command that 
will process multiple RSQL statements. Stored procedures are pre- 
compiled and stored in the RSQL system catalog and can be 
specified with arguments that will be resolved when the procedure 
is called. 


The stored procedure consists of all statements specified up to the 
end procedure. The name of the procedure is proc_name, and it 
must not duplicate any other procedure name stored on the server. 
A stored procedure is owned by the user who created it. You can 
define stored procedures with arguments. The type_spec specifies 
the type of argument and is used to validate type compatibility 
whenever the procedure is called. Default values for the arguments 
can be specified. The length of arguments of type char and the 
precision and scale of arguments of type decimal is determined 
from the context in which the argument is used. The arguments are 
referenced in the procedure's SQL statements by name. 


Stored procedures are invoked by the execute command. 


Stored procedures can contain calls to other stored procedures. A 
stored procedure can contain any RDS SQL DML statement except 
create procedure, create temporary table, and create view. 
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create procedure 
Create a stored procedure 


tt PN ee — 


The SQL statements contained in the create procedure statement 
can but do not need to be separated by semi-colons. If you are 
using the RSQL interactive utility and you are using the semi-colons 
to separate the SQL statements, make sure that you do not end å 
line with a semi-colon because the utility will interpret that as the 
end of the statement, prematurely sending the create procedure to 
the server before you've entered the end procedure clause. 


See Also 
drop procedure, execute 


Example 


create procedure order_report (start_date date, end_date date default 
today) as 
select sale_name, company, ord_num, ord_date, amount, tax 
from salesperson, customer, sales_order 
where salesperson.sale_id = customer.sale_id and 
customer.cust_id = sales_order.cust_id and 
ord_date between start_date and end_date 
end procedure; 
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create table 
Create a database table 


create table Create a database table 


Syntax create table base table name ["description"] 
(column defn [, column defn]... [, table constraint]... ) 
[in file name] 


table constraint: 
{unique | primary key)(column name |, column name]...) 
| foreign key (column name [, column name]...) 
references table name[(column namel, column name]...) 
| — check(cond expr) 


table name: 
[dbname.]base table name 


column defn: 
column name column spec ["description"] 


column spec: 
type spec [default {constant | null}] 
[not null] [unique | primary key] 
[references table namel[ (column name)] 
[check(cond expr)] 


type spec: 

(varchar | char) (length) 
| {double [precision] | float) 
| real 
| {integer | int | long} 
| {smallint | short} 
| decimal [( precision[, scale] )] 
| date 
| — time [(precision)] 
| timestamp [(precision)] 
| rowid 
| 


c_data[dims] c_type_spec 


(Continued) 
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create table 


Create a database table 


Statement Type 


Description 


13-40 


(Continued) 


c_type_spec: 
c_base_type 
| struct | 
base type field name[dims] ; 
[base type field name[dims] ;]... 
y 


dims: 
Tdim1'T [ [dim2'] [ T'dim3 T ]] 

c_base_type: 

[unsigned] {char | short | int | long}! float | double 


DDL 


The name of the table base_table_name is an identifier which must be 
unique from all other tables or views in the database. The table and 
its columns can be specified with an associated description string 
which is stored in the RDS SQL system catalog. 


The unique table constraint specifies that the column (or columns 
taken together), must contain a different value for each row in the 
table. The primary key clause identifies the column (or columns 
taken together) which must be unique and which forms the primary 
key of the table. A given table can have only one primary key. A 
unique or primary key can be composed of up to eight columns. 
Only tables with a unique or primary key constraint can be 
specified in a references clause of another create table statement. 
All unique and (non-rowid) primary keys must be indexed. If you 
do not specify a create index, sddlp will automatically create the 
index for you. Primary keys of type rowid do not need to be 
indexed. 


You can use the check clause to define a condition that must be true 
for every value of the column in the database. This condition can 
include constants and call built-in or user-defined functions but can 
only refer to the single column. The check condition cannot have a 
subquery. 


The in clause can be used to specify the name of the file in which 
the rows of the table are stored. If not specified, the rows will be 
stored in a separate file with a name derived by the system from the 
database name, and having the default page size. 
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create table 


Create a database table 
=== WWF ale å database table 


Each column of the base table is defined by an identifier, 
column_name, and a data type. The column name must be distinct 
from the other columns in this table but can be used in other tables. 
A column can be identified as containing only non-null data, unique 
values or as the table's primary key. The references clause 
identifies the column as a foreign key. 


Language Reference 


The following table explains the characteristics of each data type. 
All types are stored in the server computer's native format for the 
specified type. 


char 


varchar 


float 


real 


integer 


smallint 


decimal 


date 


time 


A fixed-length character string of the specified length. 
Stored as a null-terminated string of length+1 bytes. 


A variable-length character string of the specified 
maximum length. Stored as a null-terminated string. In 
this release, this is the same as char. 


A double precision floating point number (usually 8 
bytes long). Same as double or double precision. 


A single precision floating point number (usually 4 bytes 
long). 


A 4-byte signed integer number between -2,147,483,648 
and +2,147,438,647. Same as int, long, or longint. 


A 2-byte signed integer number between -32,768 and 
+32,767. Same as short. 


A binary-coded decimal number consisting of the 
specified scale and precision. 


A long containing the number of elapsed days since Dec 
31, 1 BC (that is, Jan 1, 1 AD is 1). 


A long containing a four decimal, fixed point time of the 


form HHMMSS.dddd. 


timestamp Contains both a date and time value. 


rowid 


A row id number value. Row ids are assigned serially 
by the system, and consist of a monotonic long integer 
value that is equal to the record number in the database 
file that contains a particular row of a table. Row ids are 
available for use with primary and foreign keys to 
provide direct access capabilities and reduce the need 
for indexes. 
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create table 
Create a database table 


c_data Contains a C language-based array or structure data 
values. Databases containing c_data columns cannot be 
update through RDS SQL. Modifications can only be 
made using the low-level RDS d_ API. The ability to 
declare columns of this type is primarily to provide for 
compatibility with Raima Data Manager applications 
that have migrated to RDS where SQL access is desired 
for queries and reports. Refer to the RDS SQL C 
Programmer's Guide for detailed information on the use 
of c_data columns. 


See Also . Aes 
Create index, create join 


Example 


create table salesperson 


( 


sale_id char(3) primary key, 

sale_name char(3) not null, 

commission float "salesperson's commission rate", 

region smallint "regional U.S. sales area", 

mgr_id char(3) references salesperson 
"salesperson id of sales mgr" 


); 
create table customer 
( 

cust id char(3) primary key, 

company char(30) not null, 

street char(30), 

city char(17) 

state char(2) 

zip char(2), 

phone char(2) not null, 

sale id char(3) not null references salesperson 

"salesperson who services customer account" 


, 


, 
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create temporary table 


Dynamically create a temporary table 
SS May Create a temporary table 


create temporary Dynamically create a temporary table 


table 


Syntax 


Statement Type 


Description 


See Also 


Language Reference 


create temporary table temp table name ["description"] 
(column defn [, column defn]...) 


column defn: 
column name column spec ["description"] 


column spec: 
type spec [default {constant | null}] [not null] 


type_spec: 
{varchar | char} (length) 

I {double [precision] | float) 
| real 

| {integer | int | long} 

| {smallint | short) 

| decimal [( precision[, scale] )] 
| 

| 

l 

| 


date 
time [(precision)] 

timestamp [(precision)] 
rowid 


DML 


A temporary table is one that is created by a user to hold temporary 
results (usually from a select statement on a permament database) 
from which additional queries will be processed. A temporary table 
is visible only to the user who creates it and it is automatically 
dropped by the system when the user disconnects. 


Indexes can be created on temporary tables. They must be 
specified, using create index, before any rows are inserted into the 
table. 


create index, drop table 
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create temporary table 


Example 


create temporary table sp_sales ( 
company char(30), 
city char(17), 
state char(2), 
ord_date date, 
amount float 


); 
insert into sp sales 


from customer, sales order 
where customer.sale id = "SKM" and 


order by 1, 4; 
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create index skm ndx on sp sales(state); 


select company, city, state, ord date, amount 


customer.cust id = sales order.cust id 
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create view 


Create a view 
$A SSS rette A vien 


create view 


Syntax 


Statement Type 


Description 


Language Reference 


Create a view 


create view table name ["description"] [(view column list)] 
as select 
[with check option] 


view column list: 
column name [, column name]... 


DML 


The create view statement is used to specify a view of a table (or 
tables). The view is defined by a select statement which can restrict 
the number of visible columns of the table or tables that are 
referenced in the select. 


The table defined by the view is the one that results from execution 
of the specified query. The select expressions are used to constrain 
the visible columns in the view. The where clause of the select 
statement can be used to constrain the rows of the view to only 
those that satisfy the condition. 


If a view column list is not specified then the names of the columns 
of the view are the same as the names of the columns in the select 
statement. If any of the columns in the select statement are 
expressions or if two columns have the same name then a view 
column list must be specified. 


A view is considered updateable (that is, it can be the table 
referenced in an insert, delete or update statement) when the select 
statement that defines the view: 


- does not contain a distinct, group by or order by clause, 
or a subquery; 


7 does not contain any column expressions; and 


- has a from clause that refers to only a single table and if 
that table is itself a view then that view must be 
updateable. 


A view that has a with check option specification must be 
updateable. When specified, the with check option will require 
that any insert or update statements that reference the view satisfy 
the where condition of the view's defining select statement. 


The create view statement cannot be executed inside a transaction. 
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create view 
Create a view 


See Also P 
create table, drop view 


Examples 


A view named acct_sale can be defined for the sales database with 
the following create view statement: 


create view acct_sale as 


select * from path 
salesperson to customer to sales_order; 


The acct_sale view can be given its own column names by 
including column aliases as in the following example: 


create view acct_sale(sale_id, name, svc_area, company, order_number, 
order_date, total) 


as select sale_id, sale_name, region, company, ord_num, ord_date, amount 
+ tax 


from path salesperson to customer to sales_order; 


The following view of the customer table could be used by 
salespersons who only service customers on the west coast. 


create view pacific as 


select * from customer where state in ("CA","OR", "WA") 
with check option; 


The with check option ensures that the where clause will be 
checked for each insert and update statement. 
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deactivate index 
Deactivate optional index 
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deactivate index Deactivate optional index 


Syntax deactivate [optional] index index_name 


Statement Type DML 


Description This statement deactivates an optional index. Optional indexes are 
indexes that can be deactivated. When an optional index is 
deactivated, the index is not used by the SQL system: insert 
statements will not store the key values and the optimizer will not 
use the index. When an optional index is active it operates just like 
any other index. The activate and deactivate index statements are 
used to enable/disable use of an optional index. 


The deactivate index statement marks the optional index as 
inactive. 


The SQL query optimizer will only utilize active indexes. If a view 
or stored procedure is executed that uses an inactive index, SQL 
will return an error code (errACTINDEX, 14039) indicating the 
condition. 


See Also activate index, create optional index 


Example 


deactivate index search_keyl; 
deactivate index search_key2; 

lock table lookup_table exclusive; 

insert into lookup_table from file "newrows.txt" on mydev; 
commit; 

activate index search_keyl; 
activate index search_key2; 
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delete 


Delete row(s) from a table 


delete 


Syntax 


Statement Type 


Description 


See Also 


Example 


Delete row(s) from a table 


delete from table_name 
where {cond_expr | current of cursor_name} 


DML 


The delete statement is used to delete one or more rows from a 
table. The rows of table_name that will be deleted are 1) (searched 
delete) those which satisfy the where conditional expression, or 2) 
(positioned delete) the current row associated with the named cursor. 
A positioned delete statement can only be issued from an RDS SQL 
C application program where cursor_name has been previously 
defined in the application program via a call to either the 
SQLGetCursorName or SQLSetCursorName functions. 


If the table is referenced through a foreign key of another table 
where there are one or more rows with a matching foreign key, the 
referenced rows in table_name will not be deleted. This ensures 
that referential integrity is preserved. 


If any integrity constraints are violated during the execution of the 
delete statement, the errors are reported and execution of the 
statement is aborted with all deletions made up to the point of the 
error discarded. 


insert, update 


delete from on_hand where quantity = 0; 
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drop function 
Drop a user-defined function definition 
CSAP User denned tunction definition 


drop function Drop a user-defined function definition 


Syntax drop function fcnname 


Statement Type DML 


Description This statement deletes the specified user-defined function from the 
SQL system catalog. 

See Also create function 

Example 


drop function geomean; 
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drop table 
Drop temporary table 


Sa m a A 


drop table Drop temporary table 


Syntax drop table tabname [, tabname]... 
Statement Type DML 
Description This statement drops the listed temporary tables from the SQL 


system. Each table must be a temporary table that has been created 
by the issuing user during this session. 
See Also create temporary table, initialize 


Example 


drop table skm_sales; 
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drop procedure 
Drop a stored procedure 
CCC FOP a stored procedure 


drop procedure Drop a stored procedure 


Syntax drop procedure [dbname.]proc name [cascade | restrict] 


Statement Type DML 


Description This statement deletes the stored procedure proc name (associated 
with database dbname, if specified) from the system. If cascade is 
specified (the default), all procedures that are dependent on this 
procedure (that is, other stored procedures that call this one) are 
automatically dropped as well. If restrict is specified and 
dependent procedures exist then the drop is not allowed. 


See Also create procedure 
Example 


drop procedure rim login; 
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drop view 
Drop a view 


drop view Drop a view 


Syntax drop view view_name [cascade | restrict] 
Statement Type DML 


Description This statement deletes the specified view. If cascade is specified 
(the default), all views that are dependent on this view (that is, 
other views that have referenced this view in their select statement) 
are automatically dropped as well. If restrict is specified and 
dependent views exist then the drop is not allowed. 


See Also ‘ 
create view 


Example 


drop view temp_view; 
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execute 


Execute a stored procedure 
SSS EX a stored procedure 


execute 


Syntax 


Statement Type 


Description 


See Also 


Example 


Execute a stored procedure 


{exec | execute | run} [dbname.]proc name [(arg [, arg]...)] 


DML 


This command invokes a stored procedure, proc name, associated 
with database dbname or the current database if not supplied. If the 
stored procedure was defined with arguments then there must be 
one arg for each of the defined arguments and they must be passed 
to the procedure in the order in which they were defined in the 
create procedure statement. The argument values must be literal 
constants of the correct type as specified in the procedure definition. 
You do not have to supply a value for an argument that has a 
default value. If there are subsequent arguments that you do need 
to supply values for, you can skip an argument with a comma. 


create procedure 


execute order report (date "06-01-1992", date "06-30-1992"); 


Language Reference 
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grant 


Grant user permissions 


a 


grant 


Syntax 


Statement Type 


Description 
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Grant user permissions 


grant_command_privileges: 
grant command_spec to {public | user_id [, user_id]...} 


command_spec: 
all commands 
| all commands but command[, command]... 
| commands command[, command]... 


command: 
create database 
| create view | create procedure 
| insert | update | delete 
lock table 


grant_item_privileges: 
grant {privilege [, privilege]... | all [privileges]} 
on table name to {public! user id [, user_id]...} 


privilege: 
select | delete | insert 


| update [(column name |, column name]...)] 


DML 


Two types of user privileges are available in RDS SQL. Item 
privileges specify access rights on database tables (base tables and 
views) and stored procedures. Command privileges specify the 
kinds of commands a particular user is allowed to use. 


Initially, only the owner of a database has permission to access that 
database. Access rights can be granted by the database owner to 
other users. The specific item privileges that can be granted are: 


select Grants permission to query the table. 
insert Grants permission to insert new rows into the table. 
delete Grants permission to delete rows from the table. 


update Grants permission to update the specified columns (or 
all columns if a column list is not specified) in the table. 


all Grants permission for all of the above capabilities. 
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grant 
Grant user permissions 
—— SSS Fant user permissions 


If table_name is the name of a view then insert, delete, and update 
can be specified only if the view is updateable (see create view). 


The specified privileges can be granted to all users (public) or be 
restricted to only the users specified in the grant command. 


New users do not have permission to issue DDL commands, DML 
modification commands, create view, create procedure, or lock 
table. In other words, new users are only allowed to issue retrieval 
commands and set up their own user options. To extend the 
privileges for a normal user, an administrator must issue a grant 
which identifies the specific commands that a user can issue. Two 
forms of specification are allowed. One form identifies the 
commands from the restricted list that the user can use. The other 
form (all but) grants the user all privileges except those listed in the 
statement. The available command privileges are given below. 


create database Allows user to issue any DDL 
command. 

create view Allows user to define his/her own 
views. 

create procedure Allows user to define his/her own 


stored procedures. 

insert, update, or delete Allows user to issue insert, update, or 
delete statements. 

lock table Allows user to issue lock and unlock 
table statements. 


The grant command only needs to be used to assign access rights to 


normal users. Administrator users always have complete access to 
everything. 
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grant 


Grant user permissions 


See Also 


Example 
all to 


select 
select 
select 
select 


insert, 
insert, 
insert, 
insert, 
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revoke 


public; 


on 
on 
on 
on 


salesperson to public; 
customer to public; 
sales_order to public; 
item to public; 


update, delete on salesperson to floresb; 
update, delete on customer to floresb; 
update, delete on sales_order to floresb; 
update, delete on item to floresb; 
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initialize 


Initialize a temporary table 
ľe å temporary table 


initialize Initialize a temporary table 


Syntax initialize table name [, table name]... 


Statement Type DML 


Description The initialize statement can be used to quickly delete all rows from 
a temporary table. The listed tables must all be temporary tables 
that have been created by the user issuing the initialize. 


See Also create temporary table, insert select 
Example 


initialize sp_sales; 

insert into sp_sales 
select company, city, state, ord_date, amount 
from customer, sales_order 


where customer.sale_id = "BNF" and 


customer.cust_id = sales_order.cust_id 
order by 1, 4; 
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insert file 


Insert rows into a table from a file 


insert file 


Syntax 


Statement Type 


Description 


See Also 


Example 


Insert rows into a table from a file 


insert into table name [(column name [, column name]...)] 
[from] file "filename" [, "delim"] [on devname] 
DML 


A single insert statement can be used to import multiple rows into a 
table where the values to be inserted are stored in a text file. This 
allows the insert statement to be used to perform a bulk load of a 
table. 


The specified file must reside in device devname. If no device is 
given, the file must reside in the user's device. The "delim" is a 
single character that is used to specify the field delimiter character 
used in the file. By default, the field delimiter is a comma. 


If any of the rows being inserted from the ascii file violate any of the 
integrity constraints defined on the table, the load will terminate 
with the error and all of the rows that have been inserted up to that 
point will be rolled back automatically. 


If the number of rows to be inserted is very large, it is 
recommended that either an exclusive table lock be first issued on 
table_name or the database be explicitly opened in exclusive access 
mode. Otherwise, the server will be forced to maintain a growing 
number of record locks for the table which could result is severe 
performance degradation on the server. 


insert select, insert values, lock table, open 


insert into outlet(loc_id, city, state, region) file "outlet.asc" on 


catdev; 


commit; 
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insert select 
Insert the result rows from a select statement into a table or file 


insert select Insert the result rows from a select statement into a table or file 


Syntax insert into {table_spec | file_spec} [from] select_stmt 


table_spec 
table_name [(column_name [, column_name]...)] 


file_spec 
file "filename"[, "delim"] [on devname] 


Statement Type DML 


Description This insert statement is used to either 1) export data from an RDS 
SQL database into an ASCII file or, 2) put the result rows of a select 
statement into a table (usually a temporary table). 


The insert into table statement will insert the rows from the result 
set of the specified select statement into the specified table. The 
data type and length of each result column from the select must 
exactly match the corresponding column in the table. If any of the 
rows from the select violate any integrity constraints that have been 
defined on the table, the insert is terminated and all rows that have 
been inserted up to that point are rolled back automatically. 


The insert into file statement will output the results of the specified 
select statement to the specified file on devname or the user's device 
if devname is not given. The "delim" must be a single character that 
defines the field value delimiter that will be used in the output file. 


If the number of rows to be inserted is very large, it is 
recommended that either an exclusive table lock be first issued on 
table_name or the database be explicitly opened in exclusive access 
mode. Otherwise, the server will be forced to maintain a growing 
number of record locks for the table which could result is severe 
performance degradation on the server. 
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insert select 
Insert the result rows from a select statement into a table or file 


See Also insert file, insert values, lock table, open 


Example 


create temporary table sp_sales ( 
company char(30), 
city char(17), 
state char(2), 
ord_date date, 
amount float 

)i 


insert into sp sales 
select company, city, state, ord date, amount from customer, sales order 
where customer.sale id = "SKM" and customer.cust id = sales order.cust id 
order by 1, 4; 


insert into file "skm0193.asc" on salesdev from 


select * from sp sales where ord date between date "1993-01-01" and date 
"1993-01-31"; 
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insert values 
Insert a row into a database table 


insert values Insert a row into a database table 


Syntax insert into table name [(column name |, column name]...)] 


values ({constant | null) [, {constant | null)]...) 


Statement Type DML 


Description The insert statement is used to insert a new row into a table. The 
values to be inserted are explicitly specified using the values clause. 


If a column_name list is specified, then the columns defined in 
table_name must be named. The values must be specified in the 
same order. If no columns are specified, the values must be listed 
in the same order as the columns defined in the create table for 
table_name. 


An insert must contain a non-null value for each column that is 
defined to contain only non-null data. 


Values for foreign keys are used to locate (and, if a create join 
exists, connect to) the related row of the referenced table. 


Any check clauses specified in the create table must evaluate to 
true for the insert to be successful. 


If table_name is a view then it must be updateable. If the view has 
been specified with with check option, the insert values must 
satisfy the where clause of the view. 


The example stores a new customer in the database and connects it 


to the salesperson table for Sidney Krieg. 


See Also 
delete, update 


Example 


insert into customer values("PHX", "Cardinal Caskets, 


Ine"; 
"1715 Central", "Phoenix", "AZ", "80237", 


"602-999-1993", 


"SKK" ) ; 
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lock table 
Lock table for shared/exclusive access 


lock table Lock table for shared /exclusive access 


Syntax lock table table_name { [in] share | exclusive [mode]} 


[, table name ([in] share | exclusive [mode]}]... 


Statement Type DML 


Description By default, RDS SQL will request appropriate locks as needed 
during the processing of database modification commands. 
However, this may result in multiple lock requests, which increases 
the possibility of lock contention causing transactions to have to be 
automatically aborted. The lock table command is provided so that 
all of the tables needed for a transaction can be explicitly locked in a 
single lock request. The command must specify that each table is to 
be read- (share) or write- (exclusive) locked. The lock request will 
be denied if any of the lock requests for any of the specified tables 
are denied. 


Locks are freed by issuing a commit or rollback command. Read 
(share) locks can also be freed using the unlock table command. 


A typical use for table locks is to place an exclusive lock on a table 
in order to do a bulk load, as illustrated in the following example 
which loads the inventory database from comma delimited ASCII 
text files stored in the RDS catdev device. By the way, notice the 
update stats statement following the bulk load. It is always a good 
practice (in fact, it is mandatory on a new database) to execute 
update stats after making substantial modifications to a database to 
ensure that the optimizer will generate access plans based on recent 
usage statistics. 


See Also 
unlock table 


Example 


lock table product, outlet, on_hand exclusive; 
insert into product from file "product.asc" on catdev; 
insert into outlet from file "outlet.asc" on catdev; 
insert into on_hand from file "onhand.asc" on catdev; 
commit; 


update stats on invntory; 
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Mark a transaction rollback point 


———————————==>=>=>— 43%" IMA BUTT 


mark Mark a transaction rollback point 


Syntax mark [trans | transaction | work] mark_id 


Statement Type DML 


Description This statement marks a rollback point within a transaction. All 
database modifications made between execution of mark 
transaction and a subsequent rollback statement with the same 
mark_id will be discarded. 


A commit must not include mark_id. In other words, commit is 
used to commit all of the modifications within a single transaction. 
Transactions cannot be nested. The mark statement only provides 
the ability to roll back a portion of the changes made within a 
transaction without having to abort the entire transaction. 


See Also begin, commit, rollback 


Example 


begin transaction new_order; 

/* get new customer info */ 
insert into customer values(...); 
mark transaction order_info; 

/* get sales order info */ 
insert into sales order values(...) 
/* get product info */ 

if insufficient quantity 
rollback order info; 
commit transaction new order; 


/* at least the new customer will be entered */ 
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open 
Open database(s) 


open 


Syntax 


Statement Type 


Description 
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Open database(s) 


open dbname [, dbname]... 
[[as] {shared | temporary | exclusive [with transaction off]}] 


DML 


The open statement opens the specified databases. Three open 
modes are available as follows. 


shared 


temporary 


exclusive 


Multiple users can be accessing the databases at the 
same time. 


This mode opens the databases in temporary mode. 
In this mode, the database is initially empty. All 
data that is subsequently inserted into the database 
is private, visible only to the one user. The data is 
dropped when the user disconnects. The database 
being opened in temporary mode, however, must 
have a valid DDL that has previously been 
processed by sddlp. If you open an existing 
database (that is, one that already contains data) in 
temporary mode, the data in the permanent 
database is not accessed. Instead, RDS creates a 
new database with the same definition. 


Only one user can have the database open. If the 
with transaction off clause is specified then 
database transactions will not be logged. This 
results in the fastest possible operation but there 
will be no recovery possible when transaction 
logging is turned off. 


A database must be opened before it can be accessed. If you do not 
explicitly open a database before using it, RDS SQL will 
automatically open it in shared mode. 
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open 


Open database(s) 
PEN dattabasets; 


See Also close 


Example 


..do as fast a load as possible 
open invntory exclusive with transaction off; 

insert into product from file "product.txt" on catdev; 
insert into outlet from file "outlet.txt" on catdev; 
insert into on hand from file "onhand.txt" on catdev; 
commit; 

close invntory; 

update stats on invntory; 
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revoke 


Revoke user permissions 


revoke 


Syntax 


Statement Type 


Description 
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Revoke user permissions 


revoke_item_privileges: 
revoke {privilege [, privilege]... | all [privileges]} 
on table_name from {public | user_id [, user_id]...} 
privilege: 
select | delete | insert 
| update [(column_name [, column name]...)] 


revoke_command_privileges: 
revoke cmd spec from {public | user id[, user_id]...} 


cmd spec: 
all commands 
all commands but command[, command]... 
commands command[, command]... 


create database 

create view | create procedure 
insert | update | delete 

lock table 


DML 


Two types of user privileges are available in RDS SQL. Item 
privileges specify access rights on database tables (base tables and 
views) and stored procedures. Command privileges specify the 
kinds of commands a particular user is allowed to use. 


Initially, only the owner of a database has permission to access that 
database. Access rights can be granted and revoked by the database 
owner to other users. The specific privileges that can be revoked 
are the same as those that can be granted and are as follows: 


select Revokes permission to query the table. 
insert Revokes permission to insert new rows into the table. 
delete Revokes permission to delete rows from the table. 


update Revokes permission to update the table. 


all Revokes permission to access the table. 
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Revoke user permissions 


The specified privileges that are being revoked must have been 
previously granted, and can be revoked from all users (public) or 
be restricted from only the users specified in the revoke command. 


To rescind command privileges, an administrator can issue a 
revoke which identifies the specific commands that a user can no 
longer issue. These specifications take two forms. One form 
identifies those commands from the restricted list that the user can 
no longer use. The other form, known as all but, identifies those 
commands from the restricted list that the user can use. The 
command types are described below. 


create database Revokes user's permission to issue any 
DDL command. 

create view Revokes user's permission to define 
his/her own views. 

create procedure Revokes user's permission to define 


his/her own stored procedures. 
insert, update, or delete Revokes user's permission to issue 
insert, update, or delete statements. 
lock table Revokes user's permission to issue lock 
and unlock table statements. 


When a user's select privilege on a table is revoked, all views which 
that user has defined on that table are automatically dropped. 


The grant and revoke commands only need to be used to assign 
access rights to normal users. Administrator users always have 
complete access to everything. 


See Also grant 


Example 


-- only administrators can modify the salesperson table 
revoke insert, update, delete on salesperson from public; 


-- restrict database creation to administrators only 
revoke create database from all; 
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rollback 
Discard all changes made since a transaction mark or start 


rollback Discard all changes made since a transaction mark or start 


Syntax rollback [work | trans | transaction] [trans id] 


Statement Type DML 


Description The rollback statement discards all database changes made since 
the most recent of the following events in the following order: 


1) a mark transaction was issued with matching trans id, or 
2) a begin transaction was issued, or 
3) acommit transaction was issued, or 


4) the database was opened. 


See Also begin, commit, mark 
Example 


begin work; 
/* make some changes to the database */ 


/* system detects invalid data */ 


rollback work; 
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select 


Syntax 


Statement Type 


Description 


Language Reference 


select 
Retrieve selected columns and rows 


Retrieve selected columns and rows 


select [distinct] (* | expression [alias] [, expression [alias]]... } 
from table_list 
[where cond_expr] [for update | [group_by] order_by] 


group_by: 
[group by col ref [, col ref)... [having cond_expr]] 


order_by: 
[order by col ref [asc | desc] [, col ref [asc | desc]]... 


alias: 


identifier 


| "alt hdg" 


column ref: 
number | [tabname.]colname 


table list: 
tabname [correlation name] [, tabname [correlation name]]... 


DML 


The select statement retrieves selected data from the specified 
table(s). The output from a select consists of rows and columns of 
data values: Each row corresponds to one occurrence from the 
table(s) and each column contains the result of an expression of 
columns from that row. 


The data to be retrieved is specified in a comma-separated list of 
result column expressions following the select. Each column 
expression can specify the name of a table column or an expression 
involving columns from the table(s) being processed. Refer to 
section 13.3 for detailed information about the formulation of 
expressions. Column expressions can have an alias or an alternate 
heading string. The alias can be referenced in order by or group by 
clauses. 
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select 


Retrieve selected columns and rows 


13-70 


To select all of the columns in the specified table(s), enter an asterisk 
(*) in place of the list of columns. 


The distinct clause ensures that the result set does not contain any 
duplicate rows. This clause should be specified only when 
absolutely necessary, as it will cause RDS SQL to sort the entire 
result set in order to be able to check for duplicate rows. This sort 
will be expensive when the result set is large. 


The from clause contains a comma-separated list of tables or views 
identifying the tables from which the selected data is to be retrieved. 
Conditional expressions (e.g., join predicates) included in the where 
clause are used by RDS SQL to determine the optimum access path. 


Inter-database joins are specified by including the database name as 
part of the table name (that is, "dbname.base table name"). 


The where clause specifies a condition that must be satisfied (that is, 
that evaluates to TRUE) for a candidate row to be reported. The 
conditional expression (cond_expr) involving comparisons of data 
fields and constants is formulated as described in section 13.4. If the 
select statement includes a group by clause, only those rows that 
satisfy the where clause participate in the grouping calculations. 


The for update clause indicates that the retrieved rows are to be 
write-locked at the time they are retrieved by the select statement 
indicating that they will subsequently be modified through an 
update statement. The for update clause cannot be specified on 
select statements that include a group by or order by clause. 


The group by clause defines a set of aggregate rows upon which 
computations are to be made. An aggregate consists of those rows 
that have identical values in the columns named in the group by 
specification. Each of the other selected columns should either have 
a unique value within each aggregate or be a computation 
involving use of one or more of the calculation functions defined in 
section 13.3.2. Only one row is reported for each aggregate 
resulting from the select. A column reference can be either the 
number of the ordinal position of the column in the list, or the 
column name. 


The having clause is:similar to the where clause in that it is used to 
conditionally select which resultant rows will be reported. The 
having conditional expression, however, is not evaluated until after 
the group by processing has been performed. The conditional 
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select 
Retrieve selected columns and rows 


expression is formed as specified in section 13.4 and will include 
comparisons that involve the calculation functions specified in the 
select column list. 


The resultant rows of a select statement can be sorted using the 
order by clause to specify the columns on which the sort is to be 
performed, and to specify if those columns are sorted in ascending 
(default) or descending order. The column references are specified 
by either the column name or by its ordinal position in the select list 
(that is, the first column is 1, the second 2, etc.). The first column 
listed will be the major sort column, the values in the second 
column will be sorted within each of the major columns values, and 
so on. 


Example 


select company, ord_num, ord_date, amount, tax, amount+tax total 
from customer, sales_order 
where customer.cust_id = sales_order.cust_id; 


select sale_name, amount from salesperson, customer, sales_order 
where amount >= 10000.00 and salesperson.sale_id = customer.sale_id and 
customer.cust_id = sales_order.cust_id 
order by amount desc; 


select company, city, state, phone from customer 
where company like "Micro$"; 


select sale_name, company, city, state from salesperson s, customer c 
where s.sale_id = c.sale_id and state in ("ID", "OR", "WA") 
order by state; 


select company, ord_date, amount from customer, sales_order 
where customer.cust_id = sales_order.cust_id and 
ord date between @"93-06-01" and @"93-06-30"; 


select sale_id, sum(amount), avg(amount), min(amount), max(amount) 
from salesperson, customer, sales_order 
where salesperson.sale_id = customer.sale_id and customer.cust_id = 
sales_order.cust_id 
group by sale_name; 
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set cpu_ratio 
Set optimizer rows per I/O cpu ratio 


set cpu_ratio Set optimizer rows per I/O cpu ratio 


Syntax set cpu_ratio to constant 


Statement Type DML 


Description The RDS SQL query optimizer estimates the cost of a candidate 
access plan as the total number of logical I/O's required to execute 
the entire query. CPU time is factored in based on the number of 
candidate rows that are fetched but eliminated due to restrictions 
specified in the where clause. The CPU cost of evaluating the 
where for the additional candidate rows that are not part of the 
result set can be expensive. 


RDS SQL factors in this CPU cost as a ratio of the number of 
candidate rows that can be checked per I/O. The default value is 
set to 5.35 rows per I/O. The set cpu ratio command can be used 
to change this value for the duration of the user's session. 
Administrators can permanently set this value. Refer to section 12.5 
for more information. 


Only administrators can issue this statement. 


See Also set opt limit, set opt yield 


Example 


set cpu_ratio to 17.5; 
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set currency 


Syntax 


Statement Type 


Description 


See Also 


Example 


set currency 
Set currency symbol 


Set currency symbol 


set currency to "<char>" 


DML 


This set statement can be used to set the default currency symbol to 
the specified "<char>". The system currency symbol is configured 
by the RDS system administrator. The dollar sign ($) is the default. 


The specified currency symbol will be assigned to the issuing user 
until it is changed by a subsequent set currency statement or until 
the user disconnects from the server. Administrators can 
permanently set this value. Refer to section 12.5 for more 
information. 


The currency symbol is specially recognized by the convert 
function. 


set display 


set currency to "£"; 


select ord_date, 


convert (amount, char, 12, "£#,#.##") amount 


from sales_order; 


Language Reference 
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set date default 
Set the default date constant format 


set date default 


Syntax 


Statement Type 


Description 


See Also 


Example 


Set the default date constant format 


set date default to "format" 
DML 


This statement is used to set the format for date constants. The date 
format string must be one of the following: "MM-DD-YYYY", 
"YYYY-MM-DD", or "DD-MM-YYYY". The separator character "-" 
shown can be any special character except ":". Thus, 
"MM/DD/YYYY" is a valid date format. 


The system default is "YYYY-MM-DD", which conforms to the 
SQL2/ODEC specification. 


This command changes the date format only for the issuing user's 
session. The system default can only be changed by an 
administrator. Refer to section 12.5 for more information. 


set display 


set date default to "MM/DD/YYYY"; 
select ord_num, ord_date, amount from sales_order 
where ord_date between date "06/01/1993" and date "06/30/1993"; 
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set decimal 


Set decimal point character 
$$ ASSET Ecma point character 


set decimal Set decimal point character 


Syntax set decimal to "<char>" 


Statement Type DML 


Description This set statement can be used to set the default decimal point 
symbol to the specified "<char>". The system decimal symbol is 
configured by the RDS system administrator. The period (.) is the 
default. 


The specified decimal symbol will be assigned to the issuing user 
until it is changed by a subsequent set decimal statement or the 
user disconnects from the server. Administrators can permanently 
set this value. Refer to section 12.5 for more information. 


The decimal symbol is specially recognized by the convert function. 


See Also set numeric separator 
Example 


set decimal to ","; 
set numeric separator to "." 


select ord_date, convert(amount, char, 12, "#.#,##") amount 
from sales_order; 
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set display 
Set default data type display format 


set display Set default data type display format 


Syntax set type display(width, "format") 


type: 


char | smallint | integer | real | float | decimal 
| date | time | timestamp 


Statement Type DML 


Description This set statement sets the default character display format for the 
specified data type. Column results of the specified type will be 
formatted as indicated in the display clause. Refer to section 13.3.4 
for a detailed description of the format specifier. 


The display format will be assigned to the issuing user until it is 
changed by a subsequent set display statement or until the user 
disconnects from the server. 

See Also convert function 


Example 


set float display(16,"S#,#.##") ; 
select ord_date, amount from sales_order where ord_num = 2206; 


ORD_DATE AMOUNT 


01-02-1993 $15,753.19 
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set opt_limit 
Set optimizer's failure-to-improve limit 


set opt_limit Set optimizer's failure-to-improve limit 


Syntax set opt_limit to constant 


Statement Type DML 


Description The time required to optimize a query grows exponentially with the 
number of tables specified in the from clause of the select 
statement. Up to about six tables, the time is negligible. For six or 
more tables, the time required to optimize can become quite 
noticeable. The algorithm that is used by RDS SQL will often, but 
not always, determine the best access plan early in the optimization 
phase. Therefore, the optimizer algorithm includes a failure-to- 
improve threshold limit based on the number of access plan step 
iterations. When the algorithm fails to generate a better access plan 
within the specified limit, the optimizer stops and uses the best plan 
found up to that point. The number of iterations that the algorithm 
processes depends on the number of tables being accessed and the 
number of usable access methods that can be chosen. 


By default, the optimizer's failure-to-improve threshold is 1000 
iterations. Reducing this value will result in faster optimization of 
complex queries but at the risk of generating a somewhat less than 
optimal access plan. Increasing (or disabling) this value will 
increase the likelihood of producing the best access plan. 


The constant should be an integer value. Setting opt_limit to zero 
will disable the failure-to-improve check so that the optimizer will 
always run to completion checking all possible access plans. 


Only administrator users are allowed to issue the statement. 


The set opt_limit statement only changes the value for the session 
in which it is issued. To permanently change the system-wide 
default optimizer limit an administrator can issue an update 
statement on the system catalog. Refer to section 12.5 for details. 


See Also set cpu_ratio, set opt_yield 


Example 


set opt_limit = 500; 
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set opt_yield 
Set optimizer's scheduler yield threshold 


set opt_yield Set optimizer's scheduler yield threshold 


Syntax set opt_yield to constant 


Statement Type DML 


Description The RDS SQL query optimizer is CPU bound particularly when 
optimizing queries involving more than six tables. It is not good in 
a server environment for any thread to consume a large amount of 
CPU time because that will block all other threads from making any 
progress. The RDS architecture is designed using a lightweight 
multiple thread technique that gives RDS complete control over the 
management of its threads. But, since the RDS threads are only 
preemptable when a low-level RDS function is called, it is possible 
for a thread to tie up the server. 


The optimizer will periodically yield control to RDS after a specified 
number of iterations. Currently, the default is to yield after every 
500 iterations. This value can be changed using the set opt_yield 
statement. 


The constant should be an integer value. Lowering the value will 
result in a smoother distribution of CPU time among all of the 
threads but will increase the system overhead required to swap 
control among the threads. 


This statement can only be issued by administrator users. 


The set opt_yield statement only changes the value for the session 
in which it is issued. To permanently change the system-wide 
default optimizer yield threshold an administrator can issue an 
update statement on the system catalog. Refer to section 12.5 for 
details. 


See Also set cpu_ratio, set opt_limit 
Example 


set opt_yield = 100; 
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set read repeatability 
Set transaction read repeatability mode 


ee EH) MMS 


set read 
repeatability 


Syntax 


Statement Type 


Description 


See Also 


Language Reference 


Set transaction read repeatability mode 


set read repeatability {on | off) 


DML 


Read repeatability mode ensures that, within a transaction, any 
rows that have been previously read are guaranteed to have not 
been changed if those rows are re-fetched. To enforce read 
repeatability, RDS SQL will place a read lock on all rows that are 
fetched within the transaction and hold those locks until the 
transaction is either committed or rolled back. 


RDS SQL operates by default with read repeatability turned off. 
This mode, called cursor stability, places a read lock on each row 
when it is fetched from the database. If the row is modified (for 
example, through a positioned update), the read lock is upgraded to 
a write lock and, if granted, the modification is performed. If the 
row is not modified, the read lock is freed when the next row is 
fetched. Thus, in this mode it is possible for a previously fetched 
row to have been modified or deleted by another user if it is later re- 
fetched within that same transaction. The write locks on modified 
rows remain in place until the transaction ends. 


Clearly, the best performance is achieved when read repeatability is 
off. It is usually best to minimize the length of transactions, but it is 
particularly important when running with read repeatability turned 
on as there may be many more rows that will remain locked until 
the transaction completes. 


set transaction isolation 
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set thousands 
Set numeric (thousands) separator character 


set thousands Set numeric (thousands) separator character 


Syntax set thousands to "<char>" 


Statement Type DML 


Description This set statement can be used to set the default numeric thousands 


separator symbol to the specified "<char>". The system numeric 
separator symbol is configured by the RDS system administrator. 
The comma (,) is the default. 


The specified symbol will be assigned to the issuing user until it is 
changed by a subsequent set numeric statement or the user 
disconnects from the server. Administrators can permanently set 
this value. Refer to section 12.5 for more information. 


The thousands symbol is specially recognized by the convert 
function. 
See Also set decimal 
Example 


set decimal to ","; 
set thousands to "." 


select ord_date, convert(amount, char, 12, "#.#,##") 
from sales_order; 


amount 
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set transaction 
isolation 


Syntax 


Statement Type 


Description 


See Also 


Language Reference 


set transaction isolation 
Specify transaction isolation mode 


Specify transaction isolation mode 


set transaction isolation {on | off} 


DML 


The ANSI SQL standard requires that the changes made within a 
transaction be visible only to the task executing the particular 
transaction until a commit is executed which makes those changes a 
permanent part of the database. To enforce this requirement, RDS 
SQL places appropriate locks on all accessed and modified rows. 
The rows that have been modified within a given transaction 
remain write-locked until the transaction commits or is rolled-back. 
Until such time, the write-locked rows cannot be accessed by any 
other task. This standard operating mode is called transaction 
isolation. 


A task which turns off transaction isolation can read information 
from a database without having to place read locks on the accessed 
rows, thus ensuring that the task will never have to wait to see the 
results. The effect of this mode, however, is that the reading task 
will be able to access the changes made by still uncommitted 
transactions. Hence, this mode is known as dirty read mode. 


When transaction isolation is turned off by a task, the resulting 
rows of a select statement which is executed outside of a transaction 
are not locked and may, therefore, be "dirty". However, the rows 
that are fetched from a select statement executed within a transaction 
are locked according to the rules governed by the read repeatability 
mode. 


The default is to have transaction isolation mode turned on. 


begin transaction, set read repeatability 
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set timeout 


Set lock waiting timeout value 


set timeout 


Syntax 


Statement Type 


Description 


Example 


Set lock waiting timeout value 


set timeout to constant 
DML 


RDS SQL automatically places locks on accessed rows to 
synchronize database access among multiple users. In general, 
read locks are issued for select and write locks are issued for 
update and delete. If another user has the row locked, the lock 
request is queued by RDS. If the lock does not become available 
within a prescribed amount of time, the lock request fails with a 
timeout status. 


The default timeout is 30 seconds. This value can be changed for 
the session in which it is issued using the set timeout statement. 
Administrators can permanently set this value. Refer to section 12.5 
for more information. 


set timeout to 5; 
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set wild 


Syntax 


Statement Type 


Description 


Example 


set wild one to 
set wild all to 
select company, 


Language Reference 


where cust_id like "S??" and company like "*Corp*"; 


set wild 
Set wild card pattern matching character 


Set wild card pattern matching character 


set wild {all | one} to "<char>" 


DML 


This set statement is used to change the wild-card pattern matching 
characters used in the like relational operator. The wild all 
character matches any sequence of zero or more characters. The 
wild one character matches any single character. The default wild 
any is "%". The default wild one is "_". 


The new wild card character is valid only for the user who issues 
the set wild statement until that user disconnects. Administrators 
can permanently set this value. Refer to section 12.5 for more 
information. 


wom, 
SE 


neu, 
, 


city, state from customer 
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unlock table 
Free share table lock ——T—ZE——ÆR—TÆT——— 


unlock table Free share table lock 
Syntax unlock table table name [, table name] 


Statement Type DML 


Description By default, RSQL will request appropriate locks as needed during 
the processing of database modification commands. However, this 
may result in multiple lock requests, increasing the possibility of 
deadlock situations causing transactions to have to be automatically 
aborted. The lock table command is provided so that all of the 
tables needed for a transaction can be explicitly locked in a single 
lock request. Table locks are automatically unlocked by a commit 
or rollback command. Tables that are locked in shared mode can 
be explicitly unlocked using the unlock table statement. 


See Also lock table 
Example 


lock table customer, sales_order in share mode; 


select company, sum(amount), sum(tax) from customer, sales_order 


where customer.cust_id = sales_order.cust_id and sale_id = "SWR" 
group by 1; 


unlock table customer, sales_order; 
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update 
Update row(s) of a table 


update Update row(s) of a table 


Syntax update table_name 


set column_name = {expression | null} 
[, column name = {expression | null)]... 
where {cond_expr | current of cursor_name} 


Statement Type DML 


Description The update statement is used to modify the column values in a row 
(or rows) of a table. The values of the listed columns will be 
modified (subject to the constraints defined on the table) to the 
results of the specified expressions or null for either 1) (searched 
update) all rows of table_name which satisfy the where conditional 
expression or 2) ( positioned update) the current row associated with 
the named cursor. A positioned update statement can only be 
issued from an RDS SQL C application program where cursor_name 
must have been previously determined in the application program 
via a call to either the SQLGetCursorName or SQLSetCursorName 
functions. 


Columns which comprise a primary or unique key that are also 
referenced by one or more foreign keys can only be updated when 
there are no active references. However, if all of the referencing 
foreign keys participate in a create join, the update is allowed (due 
to the fact that all of the foreign key columns are virtual, so there is 
no redundant data). 


If any integrity constraints are violated during the execution of the 
update statement, the errors are reported, execution of the 
statement is aborted and all updates made up to the point of the 
error are discarded. 


If table_name is a view then it must be updateable. If the view was 
specified with the with check option, the update column values 
must satisfy the where clause of the view. 


In the following example, the update statement will move all of 
Mont Green's customer accounts to Sidney Krieg. 
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update 
Update row(s) of a table 


See Also delete, insert 


Example 


update customer 


set sale_id = "SKK" 
where sale_id = "MFG"; 
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update statistics 
Update database usage statistics 


update statistics Update database usage statistics 


Syntax update (stats | statistics} on db name [, db name]... 


Statement Type DML 


Description The update statistics statement is used to update the database 
usage statistics that are used by the RDS SQL query optimizer to 
generate query execution plans. 


The database usage statistics are collected and stored in the system 
catalog through execution of the update statistics statement. Only 
administrator users can execute this statement. These usage 
statistics will be those used by the optimizer until the next time 
update statistics is executed. Therefore, it is a good practice to 
execute it fairly regularly. 


The specified databases must either be unopened or opened in 
shared mode. Do not run update stats on a database that you have 
opened in exclusive mode. 


Example 


update statistics on sales, invntory; 
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Appendix A 
SDDLP Error Messages 


This appendix contains descriptions for the errors that can be returned from the RDS 
SQL DDL utility, SDDLP. The error messages have been sorted in alphabetical order and 
include a more complete explanation. SDDLP reports the line and column number of 
the position in the DDL file of the specific text that produced the error. 


‘(’ expected 
The check clause must be enclosed in parentheses. 


bad function table entry for function udfname in UDF DLL: dllname 
The function table entry for function udfname in the UDF DLL (NLM) dllname has a 
NULL address for the type checking function. 


c_data columns not allowed in ... 
Columns of type c_data cannot be referenced in a 1) check clause, 2) create join, 3) 
primary or unique key, 4) foreign key, or 5) create index. 


check() clause undeclared column ref: 
The referenced column has not been declared in the table. It is probably misspelled. 


column definition error 
The column declaration is not properly formulated. 


column of unique/primary key cannot allow nulls: 
The columns that comprise a unique or primary key must specify ‘not null". 


CREATE DATABASE/SCHEMA AUTHORIZATION required 
Your SQL DDL does not have a create database statement as the first statement in 
the DDL file. 


database already exists (owner=username) 


A database with the same name already exists in SYSCAT. If you are trying to 
upgrade the DDL for an existing database, use the -u command line option. 


SDDLP Error Messages A-1 


database dbname is already registered with servername 
The name in the create database statement has already been registered on the 
database server. This check is intended to protect non-SQL databases that may 
already exist on the server that happen to have the same name you are using. If you 
are simply trying to install an SQL version of an existing RDS database, use the -o 
command line option. 


database does not exist: 
The referenced database does not exist. ('... references dbname.table...') 


database not available: 
The create table dbname.tabname where dbname does not match the create 
database name. 


database SYSCAT is reserved for RDS SQL 
You cannot specify a database named syscat in a create database statement. 


decimal precision must be 1..max 
The specified decimal precision is out of range. The valid range is given in the error 


message. The maximum can be changed through an SQL configuration parameter. 


decimal scale must be 0..precision 
The scale must be within the specified range. 


duplicate column: 
A column with the same name has already been declared in the table. 


duplicate file name: 
The file name has already been specified on a previous create file statement. 


duplicate foreign key definition 
Two foreign keys containing the same columns have been declared. 


duplicate join definition: 
A create join with the same name has already been declared. 


duplicate table definition: 
The table name has already been specified on a previous create table statement. 


duplicate unique/primary key definition 
Two unique/primary keys containing the same columns have been declared. 
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error in create file 
The create file statement has not been properly formulated. 


file is never used: 
A create file has been declared that does not contain any tables or indexes. 


file not found: 
A create file has not be declared for the specified name. 


file of same name already exists: 
Table names must be distinct from file names (create file). 


foreign key column does not match reference: 
The column(s) do not match the referenced primary key in type and length. 


foreign key is member of another join 
Only one join can be defined on any given foreign key. 


foreign key not defined 
A foreign key that corresponds to the columns specified in the create join does not 
exist. 


identifier is a RDS SQL DML reserved word 


Words that comprise any part of the SQL language cannot be used as names (e.g., 
table, view, column, index, join, and file names). 


illegal data type in expression .. 


The data type of an operand in the identified operation of a check constraint 
expression is not valid for that operation. 


incorrect number of arguments 


An incorrect number of arguments are listed in the call to the specified scalar 
function. 


index file already exists: 
A create index with the same name has already been declared. 


index files cannot contain table data 


Each create file can contain data of only one type: either table rows or index entries. 
This error is returned when both an index and a table are contained in the same file. 


SDDLP Error Messages A-3 


index name duplicates column name: 
Index names must not be the same as a column name in the same table. 


invalid argument type in UDF: 
The user-defined function referenced in the check constraint expression is being 
passed an argument with an incorrect data type. 


invalid check specification 
There is a syntax error in the formulation of the check clause. 


invalid conditional expression 
There is a syntax error in the formulation of the conditional expression. 


invalid create index statement 
There is a syntax error in the formulation of the create index statement. 


invalid device: 
The specified device does not exist. Use the RDS admin utility to define RDS 
devices. 


invalid foreign key specification 
There is a syntax error in the formulation of the foreign key clause. 


invalid join member specification 
There is a syntax error in the formulation of the on or and clause of the create join 
statement. 


invalid join specification 
There is a syntax error in the formulation of the create join statement. 


invalid primary key specification 
There is a syntax error in the formulation of the primary key clause. 


invalid unique specification 
There is a syntax error in the formulation of the unique key clause. 


join members must all reference the same table 


The tables referenced by the foreign keys specified in the and clause of the create 
join must be identical. 
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member table must have one (only) foreign key 
When only a table name is specified (without listing the foreign key columns), only 
one foreign key can be defined in the table. 


must specify sort columns for each member 
One of the and clauses does not list the sort columns even though the order is 
sorted. 


no udfDescribeFcns defined UDF DLL: dllname 
The listed DLL (NLM) module does not contain a function called udfDescribeFcns. 
Refer to Chapter 5 "Server-based SQL Programming" of the SQL C Programmer's 
Guide for details. 


NOT NULL conflicts with default for 
The default for the column is null when the column has a not null clause. 


premature EOF: probably missing '*/’ 
SDDLP unexpectedly reached the end of the DDL file. You may have left off the 
"*/" from the end of a comment. 


primary key already defined 
Only one primary key can be declared on a particular table. 


primary key cannot have a default of NULL on: 
Primary and unique keys cannot have null values. 


primary key must have unique index, table: 
The create index for the primary key must be unique. Use create unique index. 


ref'd columns is not a unique/primary key 
The column(s) in a references or foreign key clause do not correspond to a unique or 
primary key. 


ref'd number of columns exceeds limit 
A foreign /unique/primary key can be comprised of up to 8 columns. 


ref'ing number of columns exceeds limit 
A foreign /unique/primary key can be comprised of up to 8 columns. 


reference to undeclared table/unique/primary key: 


Either the specified table has not been declared or it does not contain a matching 
primary or unique key. 
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reference to undefined table: 
The referenced table does not exist in specified database. ('... references 
dbname.table...') 


referenced (primary key) table must be declared before CREATE JOIN 
A create join has been declared on a foreign key to an, as yet, undeclared table that 
is to contain the referenced primary key. Both referencing and referenced tables 
must be declared before issusing the create join. 


references error. 
There is a syntax error in the formulation of the references clause. 


sort column mismatch: 
The sort columns specified for each and clause must match in type and length. 


sort columns needed only when order is sorted 
You only specify the sort columns when the create join order is sorted. 


syntax error in CREATE TABLE statement 
The create table statement has not been properly formulated. 


syntax error in SQL DDL statement 
The SQL DDL statement has not been properly formulated. 


SYSCAT inconsistency detected - SDDLP aborted 
SDDLP has encountered unexpected results from an attempted access to the SQL 
system catalog. Please call Raima Technical Support for assistance. You will 
probably need to reinstall SYSCAT. 


system catalog currently unavailable for database: dbname 
Database dbname is currently in use. No other users can be using dbname in order to 
upgrade the its DDL. 


table does not contain column: 
The column listed in a unique or primary key clause has not been declared in the 
table. 


table does not have a primary key: 


The referenced table does not have a primary (or unique) key declared. 
('... references tabname’). 
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too many array dimensions specified 
The maximum number of dimensions for a c_data column is three (3). 


unable to load UDF DLL: dllname 
SDDLP was not able to load the DLL (NLM) containing the referenced user-defined 
function. This could mean that the DLL (NLM) has not been built or RDS was not 
able to find it in the location specified by the device. 


unable to open database to initialize new files 
When an existing database is upgraded to anew DDL that contains additional files, 
the database is opened so that the new files can be initialized. This unlikely error 
occurs only when the database cannot be opened for some reason. 


undeclared user-defined function: udfname 
A check constraint referenced a user-defined function for which a create function 
has not been submitted. Even though your UDF may rely on the existence of the 
database in order to work, SDDLP needs to load it to call the type checking function 
during the compilation of the check expression that references it. Thus, you need to 
code, compile, link the DLL/ NLM, and test at least that portion of your UDF. 
Then (probably through the RSQL utility) issue the create function statement before 
running SDDLP on any DDL that references that UDF. 


undefined column: 
The column specified in the create index does not exist in the table. 


undefined device name: devname 
The name specified for a device in an on clause does not exist on the database 
server. Use the RDS admin utility to create devices. 


undefined referenced column: 
The referenced column does not exist. ('... references tabname(colname)'). The 
column name listed in the create join does not exist. 


undefined referencing column: 
A column name specified in a foreign key column list has not been declared in the 


table. undefined sort column. The column specified in the sort list does not exist. 


undefined table: 
The table specified in the create index or create join does not exist. 
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unequal number of ref'd/ref'ing columns 
The columns of a foreign key must match exactly with the unique or primary key 
that it references. 


unequal number of sort columns 
The sort columns specified for each and clause must match in number. 


unsupported data type: 
The specified data type is not supported by RDS SQL. 
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Appendix B 
RDS SQL Status/Error Codes 


This appendix contains descriptions for the error and status codes that can be returned 
from RDS SQL. The error listings have been sorted in order of the RDS SQL numeric 
error code and include: 


The RDS SQL numeric code 

The RDS SQL C constant name for the error 

A single character code indicating whether the code is a status (S) or an error (E) 
The SQL Access Group (SAG) class/subclass specification for the error 

The error message (in italics) returned from SQLError 

A full description of the error 


Note that some of the SAG classifications are not unique. This is due to their lack of 
specificity. The RDS SQL codes provide a finer granularity of specificity. Thus, whereas 
SAG only has a single code for all syntax errors (37000), RDS SQL has many syntax error 


codes. 


Also note that some of the listed errors (those without any descriptive text) are defined 
by SAG or ODBC but are not returned by any of the RDS SQL functions. They are 
included here for completeness. 


1001 
1002 


1201 


1202 


errDISCONNECT 01002 disconnect error 


errCHTRUNC 01004 data truncation 

Returned by SQLFetch to indicate that a result column returned a value larger 
than the length of the host variable container to which it was bound. Also 
returned by SQLDescribeCol, SQLGetData and SQLGetCursorName to indicate 
that the host buffer was not large enough to contain the requested column 
identifer or cursor name. Returned by SQLPutData to indicate that the user 
specified value is larger than required by the parameter. 


errENVHANDLE 02002 invalid environment handle 

The HENV parameter passed to either SQLAIlocConnect, SQLFreeEnv, 
SQLTransact, or SQLExtendedTransact is not valid. You may have forgotten to 
call SQLAllocEnv before calling SQLAIIocConnect. 


errCONHANDLE 02002 invalid server connection handle 
Returned from any function that has an HDBC argument. Typically, this error 
will indicate that the connection handle has not been allocated. 
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1203 


1701 


1702 


1703 
1801 


1802 


1803 


1804 


1807 
1811 


1900 
2100 


2101 


2102 


errSTMTHANDLE 02002 invalid statement handle 
A null statement handle was specified. Call SQLAllocStmt to allocate a valid 
statement handle. 


errNUMPAR 07001 insufficient number of parameters specified 
An attempt was made to call SQLExecute (or SQLExecDirect) before all of the 
needed parameter values have been set. 


errNOTCURSOR 07005 prepared statement is not a valid cursor 
A valid cursor specification is any select statement that references a single table 
and does not have a group by nor an order by clause. 


errTYPEATTR 07006 data value cannot be converted to C type 


errNOSERVER 08001 unable to connect to specified server 
Returned from SQLConnect when the specified server is not available on the 
network. 


errSRVOPEN 08002 connection is in use 
Returned from SQLConnect when the connection to the specified server has 
already been made. 


errNOTOPEN 08003 connection is not open 
The function was called with an unopened connection handle (i.e., one for which 
a SQLConnect has not been executed) 


errSRVREJECT 08004 connection timeout - retry 
The server timed out while attempting to process your connection request. Wait 
a few seconds and try again. 


errCONTRANS 08007 connection failure during transaction 


errSERVER 08S01 communication link failure 
The system encountered an error while interacting with the server. Possibly a 
network error or the server computer has gone down. 


errCURSOROP 09000 cursor operation conflict 


errCARDINALITY 21000 cardinality violation 
This class of error results from situations where the expected number of list items 
is incorrect. 


errVIEWMISMATCH 21000 number of view columns does not match select 
The number of view column alias names does not equal the number of select 
statement result columns. 


errNUMFCNARGS 21000 incorrect number of function arguments 
The number of arguments being passed to the RDS SQL stored procedure or 
scalar function is incorrect. 
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2111 


2112 


2200 


2202 


2204 


2205 


2212 


2300 


2400 


errINSERTVALS 21S01 insert value list does not match column list 
The number of specified values does not match the number of specified columns 
in the insert statement. 


errINSERTCOLS 21S02 degree of table does not match column list 
The number of named columns on the insert statement does not match the 
number of columns declared in the table. 


errDATA 22000 data exception 
This class of errors relates to errors in the data values being returned from a 
result set. 


errTOOLONG 22001 string value too long 
The string value specified in the insert or update statement is longer than 
allowed for the specified column. 


errDATALOST 22003 significant data lost due to truncation 

This requested data conversion resulted in a lost of significant data because the 
value contained in the result value was larger than could be stored in the result 
container. For example, you bind a short result container to a long database 
column and a value greater than 32768 is returned. 


errASGT 22005 error in parameter assignment 

Returned from SQLExecute or SQLExecDirect to indicate that the data type of a 
parameter or bound column is incompatible with the data type of the associated 
table column. 


errDIVBYO 22012 division by zero 
A division by zero occurred during the evaluation of an expression in the current 
statement. 


errINTEGRITY 23000 integrity constraint violation 

A DDL-specified integrity constraint has been violated. A referential integrity 
violation occurs when the primary key referenced by a foreign key value does 
not exist.A unique integrity violation occurs when an attempt is made to add a 
duplicate primary or unique key value into a table. A check integrity violation 
occurs when a table or column's check clause or view's with check option 
evaluation is false. If the check violation is the result of a UDF trigger, the error 
message will include: "denied by UDF in check clause". 


errCURSTATE 24000 invalid cursor state 

The cursor state of the select statement is not valid for the requested operation. 
For example, if you try to call SQLFetch before you've called SQLExecute you 
will get this error. 
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2401 


2500 


2501 


2502 


2503 


2800 


3700 


3701 


3702 


3704 


3705 


3706 
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errNOTSELECT 24000 statement type is not select 
The specified function can only be called with a statement handle that 
corresponds to a select statement. 


errTRANSACT 25000 invalid transaction state 
The requested transaction operation is not allowed in the current transaction 
state. See specific codes below. 


err TXACTIVE 25000 a transaction is already active 
An attempt was made to begin a transaction when another transaction is active 
(i.e., has not yet been committed or rolled back) for the same connection. 


errIXNOTACTIVE 25000 no transaction is active 
An attempt was made to commit or rollback when there was no active 
transaction. 


errTXSYNC 25000 transaction out of sync between sql and server 

The transaction state as understood by the client-side layer is different than that 
understood on the server. This can only occur when a transaction associated 
with this connection has either been started or ended through the RDS low-level 
API while performing SQL-based transaction oriented operations. 


errINVUSER 28000 invalid user authorization 
The specified user name and password combination are not valid for the 
specified server. 


errSYNTAX 37000 syntax error 

The specified SQL statement contains a syntax error. Supplementary 
information contained in the error message should help to isolate the specific 
problem. 


errPATTERN 37000 error in regular expression 

The like pattern must be a character string. 

errPATHSPEC 37000 error in path specification 

There is a syntax error in the path clause of the select statement. 
errFCNARG 37000 invalid function argument 

A "*" can only be specified with the count calculation function. 
errDBNOTOPEN 37000 database not open 


This error only occurs when SQL is unable to automatically open a database. 
Some other user probably has the database opened in exclusive access mode. 


errUNDEFDB 37000 undefined database: dbname 
A definition for the referenced database does not exist in the RDS SQL system 
catalog. 


Raima Database Server SQL Language Guide 


3707 


3708 


3709 


3710 


3711 


3712 


3713 


3714 


3715 


3716 


errNOTNULL 37000 must specify value for column: colname 
The named column has been declared in the DDL as not null and must have a 
(non-null) value specified for it in the insert statement. 


errVALTYPE 37000 incompatible value type specified for column: colname 
The value type specified for the named column in the insert statement is not 
compatible with the column's data type. 


errDBAPK 37000 db_addr primary keys are auto-generated: colname 
A column name specified in the column list of an insert statement is a rowid 

(db addr) primary key column. Thus, its value is automatically assigned by the 
system and, therefore, cannot be specified in an insert statement. 


errMIXEDMODE 37000 incompatible data types in expression 
The data types of the operands involved in the arithmetic or relational operation 
are not compatible. 


errCURMISMATCH 37000 update/delete invalid on specified cursor 

The statement associated with the cursor specified in the positioned update or 
delete statement does not correspond to an updateable select statement. For 
example, a select containing a group by or order by is not updateable. 


errDBAPKUPD 37000 updates to db_addr primary key not allowed: colname 
Since the values of db_addr (rowid) primary key columns can only be assigned by 
the system, attempting to assign a value to it through an update statement will 
result in this error. 


errREFPKUPD 37000 non-zero references on primary/unique key 

An attempt was made to delete a row for which there are one or more 
outstanding foreign key references. You must first delete the references (either 
by modifying the foreign key values or deleting the rows) before you will be 
allowed to delete the row. 


errNOPKUPD 37000 updates to primary/unque keys not allowed 
This error is only returned when the referenced database does not maintain 
foreign key reference counts (see the disable references count clause of the 
create database statement). 


errUNRELFK 37000 foreign key not related to specified table 
A foreign key specified in the thru clause of the path does not reference the 
related table. 


errUNDEFFK 37000 undefined foreign key 
A foreign key specified in the thru clause of the path is not defined. 
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3717 


3719 


3720 


3721 


3722 


3723 


3724 


3725 


3728 


3729 


3730 


3731 
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errNOPATH 37000 invalid access path 
No access path exists between two of the tables referenced in the specified path 
clause. 


errSORTSIZE 37000 total length of sort fields exceeds limit 
The total length of all of the columns in an order by clause is limited to 243 bytes. 


errWHERECALCS 37000 aggregate functions not allowed in where 
The where clause cannot contain any references to sum, avg, min, max, or count. 


errPARAMREF 37000 improper parameter marker placement 
A parameter marker was placed in an invalid location in the SQL statement. See 
description of SQLSetParam in the RDS SQL C Programmer's Guide for details. 


errTOOMANYROWS 37000 subquery must return only one row 

An unquantified (i.e., no any or all) subquery referenced in a comparison 
operation returns more than one row. Since the result is being compared to a 
single value, subqueries of this type must only return a single value. 


errDBNOTREFD 37000 database not referenced in defining select 

The database name qualifying the view name is not referenced in the select 
statement that defines the view. Views can only be associated with a database 
that is used by the view. 


errNOTUPDATEABLE 37000 view is not updateable 

Either 1) a view declaration that includes with check option is not updateable or 
2) a database modification statement (i.e., insert, update or delete) was issued on 
a non-updateable view. 


errVIEWCOLS 37000 view column list must be specified 
A view column list must be specified when any of the defining select statement 
column results involve more than a simple column reference. 


errRESTRICT 37000 view dependencies exist, drop not allowed 
Returned from a drop view ... restrict statement when other views exist that 
reference the view being dropped. 


errBADFORMAT 37000 invalid convert format 
The format specifier for the convert function is invalid. 
errPARAMTYPE 37000 invalid paramter type 


Returned from SQLSetParam indicating that the data type of the specified 
parameter is invalid. 


errESCAPE 37000 escape clause syntax error 
The ODBC escape clause contains a syntax error. 
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3732 


3733 


3734 


3735 


3736 


3737 


3738 


3800 


4001 


4200 


4400 


7010 


errCD_BADCOL 37000 column must be of type c_data: colname 
Only columns of type c_data can be passed into the c_data scalar function. 


errCD_NOELTNAME 37000 must specify element name for column: colname 
Columns of type c_data that are declared as struct fields must include the struct 
element name in the c_data function call. 


errCD BADELTNAME 37000 column does not contain element name: eltname 
The element name specified in the c_data function called is not defined in the 
column. 


errCD_NUMSUBS 37000 incorrect number of subscripts on: name 
The number of subscripts specified in the c_data function call for name does not 
match the declared number of dimensions. 


errCD SUBTYPE 37000 subscript must be smallint value: name 
The subscript specified for column or element name, must be a smallint (short) 
value. 


errCD_SUBRANGE 37000 subscript out of range: name 
The subscript value specified for column or element name is outside of the 
declared array dimensions. 


errCD HASCDATA 37000 can't modify tables containing c data columns 

Tables that contain c data columns cannot be modified through SQL using insert, 
update, or delete. These modifications must be made through the RDS d_ API. 
A future version will relax this restriction. 


errDUPCURSOR 3C000 duplicate cursor name 
The cursor name passed to SQLSetCursorName has already been assigned to 
another statement. 


errSERIAL 40001 transaction terminated to prevent deadlock 
Returned from SQLExecute, SQLExecDirect, or SQLFetch indicating that the 
system has automatically rolled back this transaction to prevent a deadlock 
situation on the database server. 


errACCESS 42000 user access rights violation 
The user does not have the proper privileges to perform the requested operation. 
errCHECKOPT 44000 with check option violation 


The where clause of the view referenced in the insert or update statement 
evaluated to FALSE. This view has been created with the with check option 
specified so that modifications that result in the where clause evaluating to 
FALSE are disallowed. 


errABORT 70100 operation aborted 
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10099 errNOTSUPPORTED IM001 function not supported 
RDS SQL does not supported the called ODBC function. 


14000 errBADTABLE 50000 invalid table name: tabname 
Either 1) the table name specified in a qualified column name referenced in a 
select has not been specified in the from clause, or 2) the table name specified 
with the foreign key in a thru clause of a path specification does not contain the 


named foreign key. 
14001 errDUPTABLE 50001 duplicate table: tabname 

A base table with the specified name already exists in the referenced database. 
14002 errNOTABLE 50002 table not found: tabname 

The referenced table does not exist. 
14003 errDUPVIEW 50003 duplicate view: viewname 

A view with the specified name already exists in the referenced database. 
14004 errNOVIEW S0004 view not found: viewname 

The referenced view does not exist. 
14012 errNOINDEX 50012 index not found: indexname 


The index specified in the activate or deactivate command does not exist. 


14020 errBADCOLUMN $0022 invalid column name: colname 
The specified column was not found in the SQL system catalog. 


14021 errDUPCOLUMN 50022 column already exists: colname 
The referenced column is already declared in the table or view. 


14022 errNOCOLUMN 50022 column not found 
The referenced column is not declared in the listed tables. 


14030 errBADPROC SOROO invalid procedure name: procname 
The specified procedure does not exist. 


14031 errDUPPROC SORO1 duplicate procedure name: procname 
A procedure with the same name already exists. 


14032 errBADFUNC SORO2 invalid function: funcname 
The referenced user-defined function does not exist in the specified library. 


14033 errDUPFUNC SORO3 duplicate user-defined function name: funcname 
The user-defined function of the same name already exists. 


14034 errBADUSER SORO4 invalid user name: username 
The user name specified in the grant or revoke does not exist. 


15000 errGENERAL $1000 general error 
This class of errors is for errors that do not fit into any other categories. 
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15001 


15002 


15003 


15004 


15005 


15007 


15008 


15009 


15010 


15011 


15012 


15014 


15015 


errDRVMEMORY S1001 insufficient memory on client 
The client workstation does not have enough memory for the system to process 
the requested function. 


errSRVMEMORY S1001 insufficient memory on server 
The server computer does not have enough memory to complete the operation. 
errCOLNUMBER 51002 column number out of range 


The column number passed to SQLBindCol, SQLGetData, or SQLDescribeCol is 
not valid for the specified select statement. It should be between 1 and the 
number of result columns in the select list. 


errPROGTYPE 51003 program type argument out of range 
The C data type argument is invalid. 

errSQLTYPE 51004 SQL data type argument out of range 
The SQL data type argument is invalid. 

errINVARG $1009 invalid argument value 

A null handle or invalid option was passed to the function. 
errFCNSEQ S1010 function sequence error 


This function was called out of sequence. In other words, one or more other 
functions must first be called before calling the function that returned this error. 
Consult the function description for details. 


errOPENHDBCS 51010 must free all connection handles first 
SQLFreeEnv was called before all open connections have been closed. 
errPREPARED 51010 statement not prepared 


An attempt was made to execute an uncompiled statement. Call SQLPrepare 
before calling SQLExecute. You can call SQLExecDirect to both compile and 
execute a statement. 


errEXECUTED 51010 statement has not been executed 
The statement associated with the specified HSTMT must first be executed by 
calling SQLExecute before you can call this function. 


errCLOSESERVER 51010 connection not closed 
Returned from SQLFreeConnect when SQLDisconnect has not first been called. 


errTXTYPE 51012 invalid transaction operation code 

The transaction type code passed to SQLTransact or SQLExtendedTransact is 
invalid. It must be one of SQL COMMIT, SQL ROLLBACK, or (additionally for 
SQLExtendedTransact), SQL BEGIN or SQL MARK. 


errNOCURSOR S1015 no cursor name available 
Cursors are only available for select statements that have been prepared. 
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15016 


15017 
15018 
15019 


15020 
15021 
15022 
15023 
15024 
15025 
15026 
15027 
15028 
15029 
15030 
15031 
15032 
15033 
15034 


15035 


15036 


errBADDATALEN $1090 invalid string or buffer length 
The length value associated with the len argument in a SQLSetParam or 
SQLBindCol call is invalid. 


errDESCRANGE S1091 descriptor type out of range 
errOPTIONRANGE S1092 option type out of range 


errPARNO S1093 parameter number out of range 
Returned by SQLSetParam when the specified parameter number is out of range 
based on the number of host references encoded in the referenced statement. 


errSCALE 51094 invalid scale value 
errFCNRANGE S1095 function type out of range 
errINFORANGE S1096 information type out of range 
errCOLRANGE S1097 column type out of range 
errSCOPERANGE 51098 scope type out of range 
errNULLRANGE 51099 nullable type out of range 
errUNIQRANGE $1100 uniqueness option type out of range 
errACCRANGE S1101 accuracy option type out of range 
errTABRANGE 51102 table type out of range 
errDIRRANGE S1103 direction option out of range 
errFETCHTYPE S1106 fetch type out of range 
errROWVALUE S1107 row value out of range 
errCONRANGE S1108 concurrency option out of range 
errNOKEYSET S1109 invalid cursor position: no keyset defd 


errNOTCAPABLE S1C00 driver not capable 
The requested function is not supported in RDS SQL. 


errINVCONVERT S1C00 invalid conversion 

A data type conversion specified in an SQLBindCol or SQLSetParam call is not 
valid. In this release, the only SQLBindCol conversions that are supported are to 
a character string. SQLSetParam does not yet support type conversions. 


errTBD S1C00 capability not yet implemented 
This function is not available in this release. 
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15037 


15038 


20000 
20001 
20007 


20008 


20009 


20010 


20011 


20012 


20013 


errNODATANEEDED S1DEO no data pending for execution values 
Parameter values needed for execution have not been specified. Call 
SQLParamData to specify the needed values. 


errTIMEOUT S1T00 timeout expired 
Returned from SQLExecute, SQLExecDirect, or SQLFetch when a timeout occurred 
while waiting for a resource to become available (e.g., unlocked). 


errRAIMAERRS RX000 Raima-dependent error codes 
errNULLPTR RX001 unexpected NULL pointer 
errSTMTLIMIT RX007 no more statement handles available 


The server does not have sufficient memory for any additional statement 
handles. 


errTRANSID RX008 invalid transaction identifier 
The transaction identifier specified in the rollback or commit operation does not 
match an active mark or begin. 


errDLLERR RX009 system error in SQL dynamic/shared library 
This error occurs when the RDS server is unable to load SQL (DLL or NLM). 
This should not happen if the system has been installed properly. Try 
reinstalling the server from the installation media. If that fails to rectify the 
problem, call Raima Technical Support. 


errOPEN RX010 database already open 
This error occurs when one of the SQL internal temporary databases cannot be 
opened. If this should ever happen call Raima Technical Support. 


errDBUNAVAIL RX011 database not available 

The requested database is not available. Either you've requested exclusive access 
or someone else has exclusive access to it. This can also occur as a result of SQL's 
being unable to get access to the system catalog database. Retry your request 
after a few seconds. 


errNOSTATS RX012 update stats has not been run on database: dbname 
RDS SQL requires that the update stats command be run on a database before 
you can compile a select statement. 


errLOADMOD RX013 unable to load module: modname 

RDS SQL was unable to load the dynamic library that contains a referenced user- 
defined function. Make sure that the directory containing the module is one that 
is in the host system's library path (e.g., LIBPATH on OS/2). 
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20014 


20015 


20016 


20017 


20018 


20019 


20021 


20022 


20023 


20999 
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errBADMOD RX014 invalid module of user-defined functions: fcnlist 

RDS SQL was unable to load the dynamic library specified in the create function 
statement. Make sure that the directory containing the module is one that is in 
the host system's library path (e.g., LIBPATH on OS/2). 


errBADDEVICE RX015 invalid device: devname 
The specified device does not exist. You create RDS devices using the RDS 
administration utility. Refer to the RDS Administrator's Guide for details. 


errUDF RX016 user-defined function error: msg 
A UDF referenced in the SQL statement returned the specifed error message. 
errUDFNOVAL RX017 no result from user-defined function: fenname 


The identified UDF did not return a result value. This indicates that the function 
has not been correctly implemented. All UDFs must return values. Refer to 
Chapter 5 - "Server-based SQL Programming" in the RDS SQL C Programmer's 
Guide for more information. 


errUDFNORESET RX018 no reset callback for aggregate user-defined function 
An aggregate UDF must have a reset function in order to reinitialize the 
accumulation calculations when a new group is encountered. If no reset function 
is needed then the function is a scalar function and not an aggregate function. 


errBADSYSCAT RX019 unable to open system catalog 

Returned from SQLConnect the server was unable to open the SQL system 
catalog. It may be that someone (e.g., an administrator) has the system catalog 
opened in exclusive access for some reason. 


errVIEWTEMPREF RX021 a view cannot reference temporary table 

Temporary tables cannot be referenced in a view because views are persistent 
and temporary tables are not. Moreover, temporary tables are visible only to the 
one user whereas views can be used by others. 


errPROCTEMPREF RX022 a procedure cannot reference temporary table 

Stored procedures cannot reference a temporary table because procedures are 
persistent and temporary tables are not. Moreover, temporary tables are visible 
only to the one user whereas procedures can be used by others.. 


errNOTTEMP RX023 not a temporary table 
You can dynamically only issue a drop or create index statement on a temporary 
table. 


errSYSTEM RX999 system error 
An internal system error has occurred. Please contact Raima Technical Support. 
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Appendix C 
Syntax Summary 


DML Statement 


DDL_Statement 


activate_index 


Syntax Summary 


activate_index 
begin 
close_database 
commit 
create_function 
create_procedure 
create_temp_index 
create_temp_table 
create_view 
deactivate_index 
delete 
drop_function 
drop_index 
drop_procedure 
drop_table 
drop_view 
execute 

grant 

initialize 

insert 

mark 
open_database 
revoke 

rollback 

select 

set 

update 
update_stats 


create_database 
create_file 
create_index 
create_join 
create_table 


activate [optional] index index name 


arg_spec 
arith_expr 


arith_function 


arith_operand 
arith_operator 
begin 


bool_oper 


c_data_array 
c_data_dim 


c_data_spec 


c_type 
close_database 
column_defn 
column ref 


column spec 


arg name type name [default constant] 


arith operand [arith operator arith_operand]... 


(sum | avg | max | min} ( arith expr) 
count ( {* | [table name. ]column name} ) 
if (cond expr, arith_expr , arith_expr ) 
udfname (expression[, expression]...) 


numeric function 
datetime function 


system function 


constant | [table name.]|column name | arith function | ( arith_expr ) 


+l1-1%* 17 


begin (trans | transaction | work] [ trans id ] 


& | && | and 
Pub ør 


c data dim[c data dim[c data dim]] 


T number ']' 


c type 
struct '|' 


c type field name [c data array]; 
[c type field name [c data array] ;]... 


y 


[unsigned] {char | short | int | long} | float | double 


close db name [, db name]... 


column name column spec ["description"] 


number | [table name. ]|column name 


type spec 


[default constant | null] 


[not null | unique | primary key] 
[references table name[(column name)] 


[check(cond expr)] 
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command_spec 


command_type 


commit 
cond_expr 
constant 


create_database 


create_file 


create_function 


create_index 


create_join 


create_procedure 


create_table 


create_temp_index 


create_temp_table 


Syntax Summary 


all commands [but command_type[, command type]...] 
commands command_type[, command type]... 


create database 

create view | create procedure 

insert | update | delete 

lock table 

commit {trans | transaction | work} [ trans id ] 

rel_expr [bool_oper rel_expr]... 

string literal | numeric literal | user | today | now 

create {database | schema authorization} dbname [on devname] 


[{enable | disable} null values] 
[{enable | disable} references count] 


create {file | tablespace} file name [pagesize number] [on devname] 


create [scalar | aggregate] function 

udfname ["descr"] [, udfname ["descr"] ]... 
[[scalar | aggregate] function 

udfname ["descr"] [, udfname ["descr"] ]... 
in libname on devname ; 


create [optional | unique] index index name on base table name sort_cols 
[in file name] 


create join join name order {first | last | sorted} 
on base table name[( column namef[, column name]...)] [by sort_cols] 
[and base table name[( column namef[, column name]...)] [by sort_cols]]... 


create {proc | procedure) proc name [(arg_spec [, arg spec]...)] 
SQL statement [;] [SQL statement [;]]... 
end (proc | procedure) 


create table base table name ["description"] 
( column defn [, column defn]... [, table constraint]... ) [in file name] 


create [unique] index index name on temp table name sort cols 


create temporary table temp table name ["description"] 
(temp col defn [, temp col defn]...) 


C-3 


create_view 

create view view name|(alias name], alias name]...) 
as select {* | expression [,expression]... } 

from {table name [correlation name] 

[, table name [correlation name]]... | path_spec} 

[where cond_expr] 

[group by column_name [, column_name]... [having cond_expr]] 
[with check option] 


datetime_function 

age(date_expr) 
curdate() 

curtime() 
dayofmonth(date_expr) 
dayofweek(date_expr) 
dayofyear(date_expr) 
hour(time_expr) 
minute(time_expr) 
month(date_expr) 
now() 
quarter(date_expr) 
second(time_expr) 
week(date_expr) 
year(date_expr) 


deactivate_index 
deactivate [optional] index index name 


delete 

delete from table_name where {cond_expr | current of cursor name} 
drop_function 

drop function udfname[, udfname]... 
drop_index 


drop index index name 
drop_procedure 
drop {proc | procedure} proc name [cascade | restrict] 


drop_table 
drop table temp table name[, temp table name]... 
drop_view 
drop view view_name [cascade | restrict] 
execute 
{exec | execute | run} [dbname.]proc name [(constant [, constant ]...)] 
expression 
arith_expr | string expr 
grant 


grant_commands | grant_items 
grant_commands 
grant command_spec to {public | user id [, user id]...} 
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grant_items 
grant {privilege [, privilege]... | all [privileges]} 
on table name to (public | user id [, user id]...} 


initialize 

initialize temp table name[, temp table name]... 
insert 

insert_file | insert_select | insert_values 
insert_file 


insert into table name [[(column name[, column name]...)] 
[from] file "filename" [, "delim"] [on devname] 


insert select 
insert into (table name [(column namef, column name]...)] | 
file "filename" [, "delim"] [on devname]) 
[from] select 
insert_values 
insert into table name [(column name[, column name]...)] 
values ({constant | null) [, {constant | null}]...) 


lock_table 
lock table table_name { [in] share | exclusive [mode]} 
[, table name {[in] share | exclusive [mode]}]... 


mark 
mark {trans | transaction | work} mark id 


numeric_function 

abs(arith_expr) 
acos(arith_expr) 
asin(arith_expr) 
atan(arith_expr) 
atan2(arith_expr, arith_expr) 
ceiling(arith_expr) 
cos(arith_expr) 
cot(arith_expr) 
exp(arith_expr) 
floor(arith_expr) 
log(arith_expr) 

mod(arith expr, arith_expr) 
pi() 

rand(arith_expr) 
sign(arith_expr) 
sin(arith_expr) 
sqrt(arith_expr) 
tan(arith_expr) 


open_database 
open db name [, db name]... 
[[as] {shared | temporary | exclusive [with transaction off]}] 


path_leg 
[path_leg] to path_seg [and path_seg]... 


Syntax Summary 


path_seg 


path_spec 
privilege 


rel_expr 


rel_oper 


revoke 
revoke_commands 


revoke_items 


rollback 


select 


C-6 


table name [or table name]... [correlation name] 
[thru column name [, column name ]...] 
(path seg path leg) 


path table name [correlation name] path leg 
select | delete | insert | update[(column name[, column name]...)] 


expression [not] rel oper {expression | [{any | some} | all] (subquery)} 
expression [not] {between | in} constant {and | thru | :} constant 
expression [not] in ({constant [, constant]... | subquery}) 
[table_name.]column name is [not] null 

string_expr [not] like "string" 

( cond_expr ) 

not rel_expr 

[not] exists (subquery) 


revoke_commands | revoke_items 


revoke command_spec from {public | user id], user id]...} 


revoke {privilege [, privilege]... | all [privileges]} 
on table name from {public | user id[, user id]...} 


rollback {work | trans | transaction} [ trans id | mark id ] 


select {* | expression ["alt hdg"] [expression ["alt hdg"]]... } 
from {table name [correlation name] 

[, table name [correlation name]]... | path_spec} 
[where cond_expr] 
[group by column name [, column name]... [having cond_expr]] 
[order by column ref [asc | desc] [, column ref [asc | desc]]... 
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set 


sort_cols 


string_expr 


string_function 


string_operand 


subquery 


Syntax Summary 


set cpu_ratio to numeric literal 
set currency to "char" 

set date default to "format" 

set decimal to "char" 

set type name display(width, "format") 
set opt limit to numeric literal 
set opt yield to numeric literal 
set read repeatability{on | off) 
set thousands to "char" 

set timeout to numeric literal 

set transaction isolation{on | off} 
set wild {all | one} to "char" 


column name [asc | desc | sort number] 
[, column name [asc | desc | sort number]... 


string operand [^ string_operand] 


ascii(string expr) 

char(number) 

concat(string expr, string expr) 

insert(string expr, number, number, string expr) 
Icase(string_expr) 

left(string_expr) 

length(string_expr) 

locate(string_expr, string_expr, number) 
Itrim(string_expr) 

repeat(string expr, number) 
replace(string expr, string expr, string expr) 
right(string expr. number) 

rtrim(string expr) 

substring(string expr, number, number) 
ucase(string_expr) 


"string" | [table_name.]column name 
string_function 
udfname(expression, [expression]...) 


select {* | expression} 
from table name [correlation name] 
L table name [correlation name]]... | path spec) 
[where cond_expr] 
[group by column name [, column name]... [having cond_expr]] 


C-7 


system_function 


table_constraint 


table_name 


temp_col_def 


type_name 


type_spec 


unlock_table 


update 


update_stats 


C-8 


user() 
database() 
ifnull(expression, expression) 


[{unique | primary key} ( column name [, column name J... )] 
[foreign key ( column name [, column name ]... ) 
references table_name[( column name [, column name]...) 


[dbname. Jbase table name 
[dbname.]view name 


column name type_spec [default {constant | null}] [not null] 


char | character | integer | smallint | real | float | double 
decimal | date | time | timestamp | rowid 


{varchar | char}[(length)] 
double [precision] 

real 

float[(precision)] 

{integer | int | long} 
{smallint | short} 
decimal[(precision[, scale])] 
date 

time[(precision)] 
timestamp|(precision)] 
rowid 
c_data[c_data_array] c_data_spec 


unlock table table_name[, table name]... 


update table_name 
set column name = {expression | null} 

[, column name = {expression | null}]... 
where {cond_expr | current of cursor name} 


update {stats | statistics} on db name [, db name]... 
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Index 


abs 
built-in function 5-12 
numeric function 13-10 
access plan 12-7 
access rights 9-2, 13-54, 13-66 
revoking 9-4 
acos 
built-in function 5-12 
numeric function 13-10 
activate index statement 11-10, 13-24 
admin utility 12-11 
administrator user 9-1 
age 
built-in function 5-12 
aggregate 5-4, 13-8, 13-70 
rows 13-70 
aggregate calculation functions 5-5 
avg 5-5 
count 5-5 
max 5-5, 13-9 
sum 5-5 
ANSI SQL 2-2, 11-19, 13-81 
arithmetic expressions 13-5 
arithmetic operator 
table of 5-2 
ascii 
built-in function 5-12 
string function 13-7 
asin 
built-in function 5-12 
numeric function 13-10 
atan 
built-in function 5-12 
numeric function 13-10 
atan2 
built-in function 5-12 
numeric function 13-10 
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avg 
aggregate calculation functions 5-5, 
5-7 
calculation function 13-9 


begin transaction statement 7-1, 13-25 
between operation 4-6 
between operator 13-19 
boolean operation results 

table of 13-19 
boolean operators 4-5, 13-19 
built-in constants 

now 13-5 

today 13-5 

user 13-5 
built-in functions 5-12 

abs 5-12 

acos 5-12 

age 5-12 

ascii 5-12 

asin 5-12 

atan 5-12 

atan2 5-12 

c data 5-13 

ceiling 5-13 

char 5-13 

concat 5-13, 5-16 

convert 5-6, 5-13, 5-16 

cos 5-13 

cot 5-13 

curdate 5-13 

curtime 5-13 

database 5-13 

dayofmonth 5-13 

dayofyear 5-13 

exp 5-13 

floor 5-13 


Index-1 


hour 5-14 cascade 8-4 


if 5-14, 5-17 ceiling 
ifnull 5-14 built-in function 5-13 
Icase 5-14 numeric function 13-10 
left 5-14 char 13-41 
length 5-14 built-in function 5-13 
locate 5-14 data type 5-13 
log 5-14 definition of 11-6 
ltrim 5-14 string function 13-7 
minute 5-14 check clause 10-7, 11-7 
mod 5-14 clause 
month 5-14, 5-16 check 10-7, 11-7 
now 5-14 disable null values 11-3 
pi 5-14 disable references count 11-3 
quarter 5-15 enable null values 11-3 
rand 5-15 enable references count 11-3 
repeat 5-15 from 4-8 
replace 5-15 group by 2-3, 5-4 
right 5-15 having 5-10 
rtrim 5-15 on 11-2 
second 5-15 order by 2-3, 4-4 
sign 5-15 pagesize 11-4 
sin 5-15 primary key 11-7 
sqrt 5-15 references 11-7 
substring 5-15 set 7-6 
table of 5-12 values 7-2 
tan 5-15 where 4-5, 5-10 
ucase 5-15 with check option 2-3 
user 5-15 CLI. See call level interface 
week 5-15 client library 2-1 
year 5-15 close statement 4-2, 13-26 
bulk load closing databases 4-1 

fast - without logging 7-5 colstats, configuration parameters 12-12 
of table with insert statement 7-4, columns 

13-58 defined in a join 13-35 


definition of 3-1 
updating in a table 7-6 


c data 13-42 ng 
command privileges 


built-in function 5-13 


definition of data type 11-6 table of 9-2 
i commands 
system function 13-12 ne 
calculation functions 5-5, 13-8 341 


call level interface (CLI) 2-5 EE 
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.d {* | num} 2-10 
.e 2-10 
f getcursor 2-10 
.f setcursor name 2-10 
-h [num] 2-10 
.n 2-10 
.q 2-11 
.r file [par]... 2-11 
.s [file] 2-11 
t 2-11 
x 2-11 
wy 2-11 
.Z 2-11 
line arguments 
-cnum 2-7 
-hnum 2-7 
-l num 2-7 
-n 2-7 
-s num 2-7 
-w num 2-7 
startup[arg]... 2-7 
RSQL utility 
loscmd 2-8 
#num 2-8 
* 2-8 
+[num] 2-8 
-[num] 2-8 
. 2-8 
/oldtext/newtext/[g] 2-8 
; 2-8 
<enter> 2-8 
? 2-8 
@[pattern] 2-8 
comments in DDL text 11-4 
commit statement 7-2, 13-27 
comparison operators 4-6 
concat 5-16 
built-in function 5-13 
string function 13-7 
conditional expressions 4-5, 13-17 
conditional selection function 13-9 
configuring RDS SQL 12-11 
constants 13-3 


Raima Database Server SQL Language Guide 


date 4-6 
time 7-3 
constants, built-in 
now 7-4, 13-5 
today 7-4, 13-5 
user 7-4, 13-5 
convert 
built-in function 5-13 
function 5-6, 5-12, 5-16 
using 13-13 
system function 13-12 
core (ODBC) 2-5 
correlated subqueries 6-5, 13-21 
correlation names 6-7, 13-6, 13-22 
definition of 4-10 
cos 
built-in function 5-13 
numeric function 13-10 
cost-based optimizer 12-4 
cot 
built-in function 5-13 
numeric function 13-10 
count 
aggregate calculation functions 5-5 
calculation function 13-9 
count function 5-7 
cpuratio, configuration parameters 
12-13 
create database statement 13-28 
command privileges 9-2, 13-55, 13-67 
DDL 11-1 
specification 11-2 
create file statement 11-3, 13-30 
DDL 11-1 
create function statement 10-5, 13-17, 
13-32 
create index statement 11-9, 13-33 
DDL 11-1 
for temporary tables 11-20 
create join statement 2-2, 11-11, 13-35 
DDL 11-1 
create procedure statement 10-2, 13-37 
command privileges 9-2, 13-55, 13-67 


Index-3 


create schema 13-28 
create table 11-5 
create table statement 13-39 
DDL 11-1 
for temporary tables 11-20 
create tablespace 11-4 
create tablespace statement 13-30 


create temporary table statement 13-43 
create view statement 2-3, 5-7, 8-1, 13-45 
command privileges 9-2, 13-55, 13-67 


creating a stored procedure 10-2 
curdate 
built-in function 5-13 
day/time function 13-11 
currency symbol 13-73 
currsymb, configuration parameters 
12-13 
cursor stability mode 12-2, 13-79 
cursors 13-48, 13-85 
curtime 
built-in function 5-13 
day/time function 13-11 


data 
selecting from a view 8-3 
Data Definition Language (DDL) 2-4, 
13-22 
Data Manipulation Language (DML) 
2-4, 13-22 
data types 11-7, 13-12, 13-41 
ANSI SQL 2-2 
c_data 11-6 
char 5-13, 11-6 
database address 3-4 
date 11-6 
date and time 2-4 
decimal 11-6 
extended 2-2 
float 11-6 
integer 11-6 
in RDS SQL 2-6 
in SQL2 2-6 


Index-4 


RDS SQL 
c_data 13-42 
char 13-41 
date 13-41 
decimal 13-41 
float 13-41 
integer 13-41 
real 13-41 
rowid 13-41 
smallint 13-41 
time 13-41 
timestamp 13-41 
varchar 13-41 
real 11-6 
rowid 11-6 
smallint 11-6 
time 11-6 
timestamp 11-6 
varchar 11-6 
database 
access privileges 9-3 
built-in function 5-13 
concepts 
columns 3-1 
rows 3-1 
tables 3-1 
definition 11-1 
example 3-5 
inventory 3-5 
opening and closing 4-1 
sales 3-5 
sample 3-5 
security 8-5, 9-1 
system function 13-12 
versions 11-17 
Database Definition Language (DDL). 
See DDL, RDS SQL 
Database Manipulation Language 
(DML). See DML, RDS SQL 
date 13-4, 13-41 
definition of data type 11-6 
date constant formats 4-7, 7-4 
date constants 13-4 
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date format codes 
table of 13-15 
date/time format specifier 13-14 
date/time functions 
table of 13-11 
date_format, configuration parameters 
12-13 
date_sep, configuration parameters 
12-13 
dayofmonth 
built-in function 5-13 
day/time function 13-11 
dayofweek 5-13, 5-16 
built-in function 5-13 
day/time function 13-11 
dayofyear 
built-in function 5-13 
day/time function 13-11 
DDL, RDS SQL 2-1, 2-4, 9-2, 
11-1 to 11-21 
DDL processor, RDS SQL. See SDDLP 
DDL statements, RDS SQL 
11-1 to 11-13 
create database 11-1, 11-2, 13-28 
create file 11-1, 11-3, 13-30 
create index 11-1, 11-9, 13-33 
create join 11-1, 11-11, 13-35 
create table 11-1, 13-40 
table of 11-1 
ddlgen utility 11-13 
description of 11-18 
deactivate index statement 11-10 
decimal 13-41 
definition of data type 11-6 
decimal symbol 13-75 
decsymb, configuration parameters 
12-13 
default values 11-7 
delete statement 2-3, 7-7, 13-48 
access privileges 9-3 
command privileges 9-2, 13-55, 13-67 
deleting rows from a table 7-7 
detail rows 5-4, 5-10 
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device 11-2 
direct access methods 11-1 
dirty read mode 12-2 
dirty reads 12-2, 13-81 
disable null values 11-3 
disable references count 11-3 
display format 5-7 
distinct 5-5, 13-70 

using with duplicate values 5-9 
DML, RDS SQL 2-4, 13-22, 13-55, 13-67 
double 13-41 
drop function statement 13-49 
drop procedure statement 13-51 
drop table statement 13-50 
drop view statement 2-3, 8-4, 13-52 


enable null values 11-3 
enable references count 11-3 
entering data 7-1 
equi-join 2-4, 2-5, 3-4, 3-5 
errABORT B-8 
errACCESS 9-2, B-7 
errACCRANGE B-10 
errBADCOLUMN B-8 
errBADDATALEN B-10 
errBADPROC B-8 
errBADTABLE B-8 
errCARDINALITY B-2 
errCHTRUNC B-1 
errCLOSESERVER B-9 
errCOLNUMBER B-9 
errCOLRANGE B-10 
errCONHANDLE B-2 
errCONRANGE B-10 
errCONTRANS B-2 
errCURMISMATCH B-5 
errCURSOROP B-2 
errCURSTATE B-4 
errDATA B-3 
errDBAPK B-5 
errDBAPKUPD B-5 
errDBNOTOPEN B-4 


Index-5 


errDBNOTREFD B-6 
errDESCRANGE B-10 
errDIRRANGE B-10 
errDISCONNECT B-1 
errDIVBYO B-3 
errDRVMEMORY B-9 
errDUPCOLUMN B-8 
errDUPCURSOR B-7 
errDUPPROC B-8 
errDUPTABLE B-8 
errDUPVIEW B-8 
errENVHANDLE B-1 
errEXECUTED B-9 
errFCNARG B-4 
errFCNRANGE B-10 
errFCNSEQ B-9 
errFETCHTYPE B-10 
errGENERAL B-9 
errINFORANGE B-10 
errINSERTCOLS B-3 
errINSERTVALS B-3 
errINTEGRITY B-3 
errINVARG B-9 
errINVCONVERT B-10 
errINVUSER B-4 
errMIXEDMODE B-5 
errNOCOLUMN B-8 
errNOCURSOR B-10 
errNODATANEEDED B-11 
errNOKEYSET B-10 
errNOPATH B-6 
errNOPKUPD B-5 
errNOSERVER B-2 
errNOTABLE B-8 
errNOTCAPABLE B-10 
errNOTCURSOR B-2 
errNOTNULL B-5 
errNOTOPEN B-2 
errNOTSELECT B-4 
errNOTSUPPORTED B-8 
errNOTUPDATEABLE B-6 
errNOVIEW B-8 
errNULLPTR B-11 


Index-6 


errNULLRANGE B-10 
errNUMFCNARGS B-3 
errNUMPAR B-2 
errOPEN B-11 
errOPENHDBCS B-9 
errOPTIONRANGE B-10 
errPARAMREF B-6 
errPARNO B-10 
errPATHSPEC B-4 
errPATTERN B-4 
errPREPARED B-9 
errPROGTYPE B-9 
errRAIMAERRS B-11 
errREFPKUPD B-5 
errRESTRICT B-6 
errROWVALUE B-10 
errSCALE B-10 
errSCOPERANGE B-10 
errSERIAL B-7 
errSERVER B-2 
errSORTSIZE B-6 
errSQLTYPE B-9 
errSRVMEMORY B-9 
errSRVOPEN B-2 
errSRVREJECT B-2 
errSTMTHANDLE B-2 
errSTMTLIMIT B-11 
errSYNTAX B-4 
errSYSTEM B-12 
errTABRANGE B-10 
errTBD B-10 
errTIMEOUT B-11 
errTOOLONG B-3 
errTOOMANYROWS B-6 
errTRANSACT B-4 
errTRANSID B-11 
errTXACTIVE B-4 
errIXNOTACTIVE B-4 
errTXTYPE B-9 
errTYPEATTR B-2 
errUNDEFDB B-5 
errUNDEFFK B-6 
errUNIQRANGE B-10 
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errUNRELFK B-5 
errVALTYPE B-5 
errVIEWCOLS B-6 
errVIEWMISMATCH B-2 
errWHERECALCS B-6 
execute statement 10-3, 13-53, C-4 
executing a stored procedure 10-3 
execution plan 12-7 
exists 13-21 
example database 3-5 
exp 

built-in function 5-13 

numeric function 13-10 
expression evaluation 5-1 
expressions 13-5 


files 
rsql.txt 2-11 
syscat.sql 12-9 
udf.mak 10-6 
float 13-41 
definition of data type 11-6 
floor 
built-in function 5-13 
numeric function 13-10 
for update clause 12-3 
foreign key 3-5, 4-3, 7-3, 7-7 
definition of 3-3 
and predefined join 3-4 
formatting result values 13-13 
from clause 4-8 
functions 
avg calculation 5-7 
calculation 5-5, 13-8 
avg 5-5, 13-9 
count 5-5, 13-9 
max 5-5 
min 5-5, 13-9 
sum 5-5, 13-9 
concat 5-16 
convert 5-6, 5-12, 13-13 
count 5-7 
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day /time 
curdate 13-11 
curtime 13-11 
dayofmonth 13-11 
dayofweek 13-11 
dayofyear 13-11 
hour 13-12 
minute 13-12 
month 13-12 
now 13-12 
quarter 13-12 
second 13-12 
week 13-12 
year 13-12 

if 5-17 

numeric 
abs 13-10 
acos 13-10 
asin 13-10 
atan 13-10 
atan2 13-10 
ceiling 13-10 
cos 13-10 
cot 13-10 
exp 13-10 
floor 13-10 
log 13-10 
mod 13-10 
pi 13-11 
rand 13-11 
sign 13-11 
sin 13-11 
sqrt 13-11 
table of 13-9 
tan 13-11 

string 
ascii 13-7 
char 13-7 
concat 13-7 
insert 13-7 
lcase 13-7 
left 13-7 
length 13-7 


Index-7 


locate 13-7 
ltrim 13-7 
repeat 13-7 
right 13-7 
rtrim 13-8 
substring 13-8 
ucase 13-8 
string manipulation 5-16 
system 
c_data 13-12 
convert 13-12 
database 13-12 
ifnull 13-12 
user 13-12 
user-defined 2-3, 10-4 


grant statement 9-2, 13-54 

granting access rights on database tables 
9-3 

group by clause 2-3, 5-4, 5-6, 13-8, 13-70 
figure of 5-6 

grouped calculations 5-4 


having clause 5-10, 13-70 
histprec, configuration parameters 
12-12 
hour 
built-in function 5-14 
day/time function 13-12 


identifiers 13-1 
if 
built-in function 5-14 
if function 5-17, 13-9 
syntax of 5-17 
ifnull 
built-in function 5-14 
system function 13-12 
in operator 4-7, 13-19 
index 3-4 
indexes 


Index-8 


creating temporary 11-20 
and joins 11-9 
optional 11-10, 13-24, 13-47 
used with optimizer 2-3 
with create file statement 11-3 
with create index statement 11-1 
initialize statement 13-57 
inner join 3-5, 11-11 
insert 
built-in function 5-14 
from ASCII file 7-5 
string function 13-7 
insert file statement 7-5, 13-58 
insert select statement 2-2, 13-59 
insert statement 2-3, 7-2, 13-58, C-5 
access privileges 9-3 
command privileges 9-2, 13-55, 13-67 
insert values statement 2-2, 13-61 
inserting rows into a table 7-2 
integer 13-41 
definition of data type 11-6 
interactive RDS SQL utility, invoking 
2-6 
inventory database 3-5 
is [not] null 13-19 


join 2-3, 3-4 
create statement 11-10, 11-15 
equi- 3-4 
and indexes 11-9 
inner 11-11 
in multiple tables 4-7 
natural 3-4 
outer 3-5, 11-11 
predefined 3-4 
join predicate 3-4, 4-8 
joins 
predefined 11-1 


lcase 13-7 
built-in function 5-14 
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left 
built-in function 5-14 
string function 13-7 
length 
built-in function 5-14 
string function 13-7 
library 
client 2-1 
like operator 4-7, 13-19 
linking the related rows of a join 3-4 
locate 
built-in function 5-14 
string function 13-7 
lock table 12-3 
lock table statement 13-62, C-5 
command privileges 9-2, 13-55, 13-67 
locking 13-62, 13-84 
locktime, configuration parameters 12- 
13 
log 
built-in function 5-14 
numeric function 13-10 
longint 13-41 
low-level (d ) access to SQL databases 
12-14 
Itrim 
built-in function 5-14 
string function 13-7 


manual conventions 1-3 

mark transaction statement 7-2, 13-63 

max 
aggregate calculation functions 5-5 
calculation function 13-9 

maxprecision, configuration parameters 
12-13 

maxprocs, configuration parameters 
12-12 

maxscale, configuration parameters 
12-13 

maxstring, configuration parameter 
12-12 
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maxsubqval, configuration parameters 
12-12 
maxudfs, configuration parameters 
12-12 
maxviews, configuration parameters 
12-12 
min 
aggregate calculation functions 5-5 
calculation function 13-9 
minute 
built-in function 5-14 
day /time function 13-12 
mod 
built-in function 5-14 
numeric function 13-10 
modifying data 7-1 
month 
built-in function 5-14 
day /time function 13-12 
multi-user issues 12-1 
multi-valued subqueries 6-3 
multiple database access 4-9 
multiple threads 
yielding in optimizer 12-8 


natural join 3-4 
nested query 6-1 
normal user 9-1 
normalization 3-3 
notational conventions 1-3 
now 
built-in function 5-14 
day/time function 13-12 
null values 11-3 
null values clause 11-3, 13-28 
numeric constants 13-3 
numeric format specifier 13-13 
numeric functions 
table of 13-10 
numeric separator 13-80 


ODBC. See Open Database Connectivity 
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on clause 11-2 positioned delete 13-48 


one-to-many 3-3 positioned update 13-85 
Open Database Connectivity (ODBC) pre-defined joins 11-1 
2-5 precedence, arithmetic operator 5-2 
level 1 2-5 predefined join 2-3, 3-4 
level 2 2-5 primary key 2-2, 3-3, 4-3, 7-3 
SQL conformance exceptions 2-4 and predefined join 3-4 
open statement 4-1, 13-64 indexing of 11-9 
opening databases 4-1 primary key clause 11-7 
operand privileges 13-66 
definition in an expression 13-6 by grant statement 13-54 
operational overview 2-1 by revoke statement 13-66 
operators 13-8 command 9-1 
between 13-19 database 9-1 
boolean 4-5, 13-19 projection 4-3 
comparison 4-6 
in 4-7, 13-19 
quarter 


is [not] null 13-19 
like 4-7, 13-19 

list of arithmetic 5-2 
outer join 13-19 


built-in function 5-15 
day /time function 13-12 
queries 4-1, 4-7 


relational 4-6, 6-1 pois nd = 
string concatenation 5-17 RRS or 
optimizer 2-3, 3-4 sonny a4 


cost-based 12-4 subqueries 6-1 


ae 12-7 query optimizer 3-4, 12-4 
query 12-4 
optional index 11-10, 13-24, 13-33, 13-47 rand 
optlimit, configuration parameters built-in function 5-15 
12-13 numeric function 13-11 
optyield, configuration parameters RDM applications, migrating to 
12-13 RDS SQL 12-14 
order by clause 2-3, 4-4, 8-2 read repeatability mode 12-2, 13-79 
outer join 2-6, 3-5, 11-11, 13-19 real 13-41 
outer references 6-5, 13-21 definition of data type 11-6 


redundant data 3-2 
references clause 11-7 
references clount clause 13-28 
referential integrity 3-3, 11-12 
checking 2-2, 11-3, 13-28 
relational expression 13-19 
relational expressions 4-5 


pagesize 11-4 
pattern matching 13-83 
i 
built-in function 5-14 
numeric function 13-11 
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relational operator 6-1 
relational operators 4-6 
remote procedure call (RPC) 2-1 
repeat 
built-in function 5-15 
string function 13-7 
replace 13-7 
built-in function 5-15 
string function 13-7 
reserved words 13-1 
list of 13-2 
restrict 8-4 
revoke statement 9-4, 13-66 
revoking access rights 9-4 
right 
built-in function 5-15 
string function 13-7 
rollback statement 7-2, 13-68 
row id 3-4 
rowid 7-3, 13-41 
data type definition 11-6 
rows 
definition of 3-1 
deleting from a table 7-7 
inserting into a table 7-2 
restricted by clauses 5-17 
RPC. See remote procedure call 
rsql 2-7, 2-8, 2-12 
execute utility 
rsql.exe 2-6 
rsql.txt 2-11 
rtrim 
built-in function 5-15 
string function 13-8 
run 13-53, C-4 
run statement 10-3 


sales database 3-5 
sample database 3-5 
savepoints 13-63 
scalar functions 2-3 
schema 3-5 
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SDDLP (RDS SQL DDL processor) 
11-1, 13-22 
executing 11-13 
operation 11-18 
searched delete 13-48 
searched update 13-85 
second 
built-in function 5-15 
day/time function 13-12 
security 
database 9-1 
logging 12-13 
of views and database 8-5 
select statement 2-3, 4-1, 4-8, 13-69 
access privileges 9-3 
alternate column heading 5-3 
basic 4-2 
capabilities of 5-1 
group by clause 5-4 
having clause 5-10 
join 4-7 
multiple databases 4-9 
order by 4-4 
subqueries 6-1 
for update 12-3 
where clause 4-5 
selecting data from a view 8-3 
set clause 7-6 
set cpu_ratio 12-7 
set cpu_ratio statement 13-72 
set currency statement 13-73 
set date default statement 13-74 
set decimal statement 13-75 
set display statement 13-76 
set numeric separator statement 13-80 
set opt_limit 12-8 
set opt_limit statement 13-77 
set opt_yield statement 13-78 
set read repeatability statement 13-79 
set statement 5-7 
set thousands statement 13-80 
set timeout statement 13-82 
set transaction isolation statement 13-81 
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set wild statement 13-19, 13-83 
short 13-41 
sign 
built-in function 5-15 
numeric function 13-11 
sin 13-11 
built-in function 5-15 
single-valued subqueries 6-1 
smallint 13-41 
definition of data type 11-6 
sorting queries 4-4 
SQL 
standards 2-4 
SQL Access Group (SAG) 2-4 
SQL command access rights 9-2 
SQL DDL 2-1 
utilities 2-1 
SQL DDL specification 
compiling 11-13 
SQL utilities 
rsql 2-6 
SQL2 2-6, 4-7 
SQLExecute 2-11 
SQLFreeStmt 2-11 
SQLGetCursorName 2-10 
SQLMoreResults 10-4 
SQLPrepare 2-11 
sqrt 
built-in function 5-15 
numeric function 13-11 
statements 
activate index 11-10, 13-24 
begin transaction 7-2, 13-25 
close 4-2, 13-26 
commit 7-2, 13-27 
create database 13-28 
create file 13-30 


create function 10-5, 13-17, 13-32 


create index 13-33 

create join 2-2, 11-11, 13-35 
create procedure 10-2, 13-37 
create table 11-5, 13-39 
create temporary table 13-43 
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create view 2-3, 5-7, 8-1, 13-45 
deactivate index 11-10, 13-47 
delete 7-7, 13-48 

drop function 13-49 

drop procedure 13-51 
drop table 13-50 

drop view 2-3, 8-4, 13-52 
execute 10-3, 13-53 

grant 9-2, 13-54 

initialize 13-57 

insert 7-2, 13-61 

insert file 13-58 

insert select 2-2, 13-59 
insert values 2-2 

lock table 12-3, 13-62 

mark transaction 7-2, 13-63 
open 4-1, 13-64 

revoke 9-4, 13-66 

rollback 7-2, 13-68 

select 2-3, 13-69 

set 5-7 

set cpu_ratio 12-7, 13-72 
set currency 13-73 

set date default 13-74 

set decimal 13-75 

set display 13-76 

set opt_limit 12-8, 13-77 
set opt_yield 13-78 

set read repeatability 13-79 
set thousands 13-80 

set transaction isolation 13-81 
set wild 13-19, 13-83 
timeout 13-82 

unlock table 12-3, 13-84 
update 7-6, 13-85, 13-87 
update statistics 12-5 

use 4-2 


stogroup 11-3 
stored procedures 10-1 


creating 10-2, 13-37 

dropping 13-51 

executing 10-3, 13-53 
retrieving definition text 12-14 
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string concatenation operator 5-17 
string constants 13-3 
string expressions 13-5 
string functions 
table of 13-7 
string manipulation functions 5-16 
subqueries 13-20 
correlated 6-5, 13-21 
exists 6-7, 13-21 
multi-valued 6-3 
multiple-valued 13-21 
single-valued 6-1, 13-20 
subquery 6-1 
substring 
built-in function 5-15 
string function 13-8 
sum 
aggregate calculation functions 5-5 
calculation function 13-9 
syscat. See system catalog 2-1, 12-9 
syscat.sql 12-9 
sysnulls_ 12-17 
sysrefs_ 12-17 
system architecture 2-1 
system catalog 2-1, 2-3, 2-6, 10-1, 11-13, 
12-9 
system functions 
table of 13-12 


table locking 12-3 
table locks 13-62 
tables 
creating temporary 11-20 
definition of 3-1, 11-5 
in expressions 13-6 
tablespace 11-4 
tan 13-11 
built-in function 5-15 
numeric function 13-11 
temporary tables and indexes 11-20 
thousymb, configuration parameters 
12-13 
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time 13-4, 13-41 

definition of data type 11-6 
time constants 13-4 
time format codes 

table of 13-16 
timestamp 11-6, 13-4, 13-41 
timestamp constants 13-4 
transaction 2-3 

begin 13-25 

commit 13-27 

rollback 13-68 

savepoint 13-63 
transaction isolation 13-81 


multi-user control settings 12-2 


transactions 7-1 
trigger 
definition of 10-7 


ucase 
string function 13-8 

udf.mak 10-6 

unique keys 11-9 

unlock table 12-3 

unlock table statement 13-84 


update statement 2-3, 7-6, 13-85 


access privileges 9-3 


command privileges 9-2, 13-55, 13-67 
update statistics statement 12-5, 13-87 


updateable views 8-4, 13-45 


updating columns ina table 7-6 


use statement 4-2 
user 
administrator 9-1 
built-in function 5-15 
normal 9-1 
system function 13-12 
user privileges 9-3, 13-66 
user-defined function 
definition of 10-1 


user-defined functions 2-3, 10-4, 13-16 


utilities 
ddlgen 11-13 
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description of 11-18 
utilities, SOL 
rsql 
commands 2-8 
rsql.exe 2-6 


values clause 7-2 

varchar 11-6, 13-41 

views 
creating 5-7, 13-45 
creating a definition 8-1 
and database security 8-5 
defining 5-7 
dropping 13-52 
processing 2-3 
retrieving definition text 12-14 
selecting data from 8-3 
updateability 8-4 
updateable 13-45 
using 8-1 

virtual columns 13-35 


week 
built-in function 5-15 
day /time function 13-12 
where clause 4-5, 5-10, 13-70 
subqueries 6-1 
wild-card characters 13-83 
wild-card checking 4-7, 13-19 
wildall, configuration parameters 12-13 
wildone, configuration parameters 
12-13 
with check option 8-5, 13-45 


year 
built-in function 5-15 
day/time function 13-12 
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